Truy xuất dữ liệu

Tài liệu này trình bày những kiến thức cơ bản về cách truy xuất dữ liệu và cách sắp xếp cũng như lọc dữ liệu Firebase.

Trước khi bắt đầu

Trước khi có thể sử dụng Realtime Database, bạn cần:

Đăng ký dự án Unity của bạn và định cấu hình dự án đó để sử dụng Firebase.
- Nếu dự án Unity của bạn đã sử dụng Firebase, thì dự án đó đã được đăng ký và định cấu hình cho Firebase.
- Nếu không có dự án Unity, bạn có thể tải một ứng dụng mẫu xuống.
Thêm Firebase Unity SDK (cụ thể là FirebaseDatabase.unitypackage) vào dự án Unity.

Xin lưu ý rằng việc thêm Firebase vào dự án Unity bao gồm các tác vụ trong cả bảng điều khiển của Firebase và dự án Unity đang mở (ví dụ: bạn tải tệp cấu hình Firebase xuống từ bảng điều khiển, sau đó di chuyển các tệp đó vào dự án Unity).Firebase

Truy xuất dữ liệu

Dữ liệu Firebase được truy xuất bằng cách gọi GetValueAsync() một lần hoặc đính kèm vào một sự kiện trên tham chiếu FirebaseDatabase. Trình nghe sự kiện được gọi một lần cho trạng thái ban đầu của dữ liệu và gọi lại bất cứ lúc nào dữ liệu thay đổi.

Lấy DatabaseReference

Để đọc dữ liệu từ cơ sở dữ liệu, bạn cần có một thực thể của DatabaseReference:

using Firebase;
using Firebase.Database;
using Firebase.Extensions.TaskExtension; // for ContinueWithOnMainThread

public class MyScript: MonoBehaviour {
  void Start() {
    // Get the root reference location of the database.
    DatabaseReference reference = FirebaseDatabase.DefaultInstance.RootReference;
  }
}

Đọc dữ liệu một lần

Bạn có thể sử dụng GetValueAsync phương thức để đọc ảnh chụp nhanh tĩnh của nội dung tại một đường dẫn nhất định một lần. Kết quả của tác vụ sẽ chứa một ảnh chụp nhanh chứa tất cả dữ liệu tại vị trí đó, bao gồm cả dữ liệu con. Nếu không có dữ liệu, ảnh chụp nhanh được trả về là null.

    FirebaseDatabase.DefaultInstance
      .GetReference("Leaders")
      .GetValueAsync().ContinueWithOnMainThread(task =&gt {
        if (task.IsFaulted) {
          // Handle the error...
        }
        else if (task.IsCompleted) {
          DataSnapshot snapshot = task.Result;
          // Do something with snapshot...
        }
      });

Nghe sự kiện

Bạn có thể thêm trình nghe sự kiện để đăng ký các thay đổi đối với dữ liệu:

Sự kiện	Cách sử dụng thông thường
`ValueChanged`	Đọc và nghe các thay đổi đối với toàn bộ nội dung của một đường dẫn.
`ChildAdded`	Truy xuất danh sách các mục hoặc nghe các mục được thêm vào danh sách các mục. Đề xuất sử dụng với `ChildChanged` và `ChildRemoved` để theo dõi các thay đổi đối với danh sách.
`ChildChanged`	Nghe các thay đổi đối với các mục trong danh sách. Sử dụng với `ChildAdded` và `ChildRemoved` để theo dõi các thay đổi đối với danh sách.
`ChildRemoved`	Nghe các mục bị xoá khỏi danh sách. Sử dụng với `ChildAdded` và `ChildChanged` để theo dõi các thay đổi đối với danh sách.
`ChildMoved`	Nghe các thay đổi đối với thứ tự của các mục trong danh sách được sắp xếp. `ChildMoved` sự kiện luôn tuân theo `ChildChanged` sự kiện khiến thứ tự của mục thay đổi (dựa trên phương thức sắp xếp hiện tại của bạn).

Sự kiện ValueChanged

Bạn có thể sử dụng ValueChanged sự kiện để đăng ký các thay đổi đối với nội dung tại một đường dẫn nhất định. Sự kiện này được kích hoạt một lần khi trình nghe được đính kèm và kích hoạt lại mỗi khi dữ liệu (bao gồm cả dữ liệu con) thay đổi. Lệnh gọi lại sự kiện được truyền một ảnh chụp nhanh chứa tất cả dữ liệu tại vị trí đó, bao gồm cả dữ liệu con. Nếu không có dữ liệu, ảnh chụp nhanh được trả về là null.

Ví dụ sau đây minh hoạ một trò chơi truy xuất điểm số của bảng xếp hạng từ cơ sở dữ liệu:

      FirebaseDatabase.DefaultInstance
        .GetReference("Leaders")
        .ValueChanged += HandleValueChanged;
    }

    void HandleValueChanged(object sender, ValueChangedEventArgs args) {
      if (args.DatabaseError != null) {
        Debug.LogError(args.DatabaseError.Message);
        return;
      }
      // Do something with the data in args.Snapshot
    }

ValueChangedEventArgs chứa một DataSnapshot chứa dữ liệu tại vị trí được chỉ định trong cơ sở dữ liệu tại thời điểm xảy ra sự kiện. Việc gọi Value trên ảnh chụp nhanh sẽ trả về một Dictionary<string, object> đại diện cho dữ liệu. Nếu không có dữ liệu tại vị trí đó, việc gọi Value sẽ trả về null.

Trong ví dụ này, args.DatabaseError cũng được kiểm tra để xem liệu quá trình đọc có bị huỷ hay không. Ví dụ: quá trình đọc có thể bị huỷ nếu ứng dụng không có quyền đọc từ một vị trí cơ sở dữ liệu Firebase. DatabaseError sẽ cho biết lý do xảy ra lỗi.

Sau này, bạn có thể huỷ đăng ký sự kiện bằng cách sử dụng bất kỳ DatabaseReference nào có cùng đường dẫn. Các thực thể DatabaseReference là tạm thời và có thể được coi là một cách để truy cập vào bất kỳ đường dẫn và truy vấn nào.

      FirebaseDatabase.DefaultInstance
        .GetReference("Leaders")
        .ValueChanged -= HandleValueChanged; // unsubscribe from ValueChanged.
    }

Sự kiện con

Các sự kiện con được kích hoạt để phản hồi các thao tác cụ thể xảy ra đối với các phần tử con của một nút từ một thao tác, chẳng hạn như một phần tử con mới được thêm thông qua Push() phương thức hoặc một phần tử con đang được cập nhật thông qua UpdateChildrenAsync() phương thức. Mỗi sự kiện này có thể hữu ích cho việc nghe các thay đổi đối với một nút cụ thể trong cơ sở dữ liệu. Ví dụ: một trò chơi có thể sử dụng các phương thức này cùng nhau để theo dõi hoạt động trong phần bình luận của một phiên trò chơi, như minh hoạ bên dưới:

      var ref = FirebaseDatabase.DefaultInstance
      .GetReference("GameSessionComments");

      ref.ChildAdded += HandleChildAdded;
      ref.ChildChanged += HandleChildChanged;
      ref.ChildRemoved += HandleChildRemoved;
      ref.ChildMoved += HandleChildMoved;
    }

    void HandleChildAdded(object sender, ChildChangedEventArgs args) {
      if (args.DatabaseError != null) {
        Debug.LogError(args.DatabaseError.Message);
        return;
      }
      // Do something with the data in args.Snapshot
    }

    void HandleChildChanged(object sender, ChildChangedEventArgs args) {
      if (args.DatabaseError != null) {
        Debug.LogError(args.DatabaseError.Message);
        return;
      }
      // Do something with the data in args.Snapshot
    }

    void HandleChildRemoved(object sender, ChildChangedEventArgs args) {
      if (args.DatabaseError != null) {
        Debug.LogError(args.DatabaseError.Message);
        return;
      }
      // Do something with the data in args.Snapshot
    }

    void HandleChildMoved(object sender, ChildChangedEventArgs args) {
      if (args.DatabaseError != null) {
        Debug.LogError(args.DatabaseError.Message);
        return;
      }
      // Do something with the data in args.Snapshot
    }

Sự kiện ChildAdded thường được dùng để truy xuất danh sách các mục trong cơ sở dữ liệu Firebase. Sự kiện ChildAdded được kích hoạt một lần cho mỗi phần tử con hiện có, sau đó kích hoạt lại mỗi khi một phần tử con mới được thêm vào đường dẫn được chỉ định. Trình nghe được truyền một ảnh chụp nhanh chứa dữ liệu của phần tử con mới.

Sự kiện ChildChanged được kích hoạt bất cứ lúc nào một nút con được sửa đổi. Điều này bao gồm mọi sửa đổi đối với các phần tử con của nút con. Sự kiện này thường được dùng kết hợp với các sự kiện ChildAdded và ChildRemoved để phản hồi các thay đổi đối với danh sách các mục. Ảnh chụp nhanh được truyền đến trình nghe sự kiện chứa dữ liệu đã cập nhật cho phần tử con.

Sự kiện ChildRemoved được kích hoạt khi một phần tử con trực tiếp bị xoá. Sự kiện này thường được dùng kết hợp với các lệnh gọi lại ChildAdded và ChildChanged. Ảnh chụp nhanh được truyền đến lệnh gọi lại sự kiện chứa dữ liệu cho phần tử con đã xoá.

Sự kiện ChildMoved được kích hoạt bất cứ khi nào sự kiện ChildChanged được kích hoạt bởi một bản cập nhật khiến phần tử con được sắp xếp lại. Sự kiện này được dùng với dữ liệu được sắp xếp bằng OrderByChild hoặc OrderByValue.

Sắp xếp và lọc dữ liệu

Bạn có thể sử dụng lớp Realtime Database Query để truy xuất dữ liệu được sắp xếp theo khoá, theo giá trị hoặc theo giá trị của một phần tử con. Bạn cũng có thể lọc kết quả đã sắp xếp thành một số kết quả cụ thể hoặc một phạm vi khoá hoặc giá trị.

Sắp xếp dữ liệu

Để truy xuất dữ liệu đã sắp xếp, hãy bắt đầu bằng cách chỉ định một trong các phương thức sắp xếp để xác định cách sắp xếp kết quả:

Phương thức	Cách sử dụng
`OrderByChild()`	Sắp xếp kết quả theo giá trị của một khoá con được chỉ định.
`OrderByKey()`	Sắp xếp kết quả theo khoá con.
`OrderByValue()`	Sắp xếp kết quả theo giá trị con.

Bạn chỉ có thể sử dụng một phương thức sắp xếp tại một thời điểm. Việc gọi phương thức sắp xếp nhiều lần trong cùng một truy vấn sẽ gây ra lỗi.

Ví dụ sau đây minh hoạ cách bạn có thể đăng ký bảng xếp hạng điểm số được sắp xếp theo điểm số.

      FirebaseDatabase.DefaultInstance
        .GetReference("Leaders").OrderByChild("score")
        .ValueChanged += HandleValueChanged;
    }

    void HandleValueChanged(object sender, ValueChangedEventArgs args) {
      if (args.DatabaseError != null) {
        Debug.LogError(args.DatabaseError.Message);
        return;
      }
      // Do something with the data in args.Snapshot
    }

Điều này xác định một truy vấn mà khi kết hợp với trình nghe sự kiện valuechanged valuechanged sẽ đồng bộ hoá ứng dụng với bảng xếp hạng trong cơ sở dữ liệu, được sắp xếp theo điểm số của mỗi mục. Bạn có thể đọc thêm về cách cấu trúc dữ liệu một cách hiệu quả trong Cấu trúc cơ sở dữ liệu.

Lệnh gọi đến phương thức OrderByChild() chỉ định khoá con để sắp xếp kết quả. Trong trường hợp này, kết quả được sắp xếp theo giá trị của "score" giá trị trong mỗi phần tử con. Để biết thêm thông tin về cách sắp xếp các loại dữ liệu khác, hãy xem Cách sắp xếp dữ liệu truy vấn.

Lọc dữ liệu

Để lọc dữ liệu, bạn có thể kết hợp bất kỳ phương thức giới hạn hoặc phạm vi nào với phương thức sắp xếp khi tạo truy vấn.

Phương thức	Cách sử dụng
`LimitToFirst()`	Đặt số lượng mục tối đa cần trả về từ đầu danh sách kết quả được sắp xếp.
`LimitToLast()`	Đặt số lượng mục tối đa cần trả về từ cuối danh sách kết quả được sắp xếp.
`StartAt()`	Trả về các mục lớn hơn hoặc bằng khoá hoặc giá trị được chỉ định tuỳ thuộc vào phương thức sắp xếp đã chọn.
`EndAt()`	Trả về các mục nhỏ hơn hoặc bằng khoá hoặc giá trị được chỉ định tuỳ thuộc vào phương thức sắp xếp đã chọn.
`EqualTo()`	Trả về các mục bằng khoá hoặc giá trị được chỉ định tuỳ thuộc vào phương thức sắp xếp đã chọn.

Không giống như các phương thức sắp xếp, bạn có thể kết hợp nhiều hàm giới hạn hoặc phạm vi. Ví dụ: bạn có thể kết hợp các phương thức StartAt() và EndAt() để giới hạn kết quả trong một phạm vi giá trị được chỉ định.

Ngay cả khi chỉ có một kết quả phù hợp cho truy vấn, ảnh chụp nhanh vẫn là một danh sách; ảnh chụp nhanh chỉ chứa một mục.

Giới hạn số lượng kết quả

Bạn có thể sử dụng các phương thức LimitToFirst() và LimitToLast() để đặt số lượng phần tử con tối đa cần đồng bộ hoá cho một lệnh gọi lại nhất định. Ví dụ: nếu bạn sử dụng LimitToFirst() để đặt giới hạn là 100, thì ban đầu bạn chỉ nhận được tối đa 100 lệnh gọi lại ChildAdded. Nếu bạn có ít hơn 100 mục được lưu trữ trong cơ sở dữ liệu Firebase, thì lệnh gọi lại ChildAdded sẽ kích hoạt cho mỗi mục.

Khi các mục thay đổi, bạn sẽ nhận được lệnh gọi lại ChildAdded cho các mục nhập truy vấn và lệnh gọi lại ChildRemoved cho các mục bị loại bỏ khỏi truy vấn để tổng số vẫn là 100.

Ví dụ: mã bên dưới trả về điểm số cao nhất từ bảng xếp hạng:

      FirebaseDatabase.DefaultInstance
        .GetReference("Leaders").OrderByChild("score").LimitToLast(1)
        .ValueChanged += HandleValueChanged;
    }

    void HandleValueChanged(object sender, ValueChangedEventArgs args) {
      if (args.DatabaseError != null) {
        Debug.LogError(args.DatabaseError.Message);
        return;
      }
      // Do something with the data in args.Snapshot
    }

Lọc theo khoá hoặc giá trị

Bạn có thể sử dụng StartAt(), EndAt() và EqualTo() để chọn điểm bắt đầu, điểm kết thúc và điểm tương đương tuỳ ý cho các truy vấn. Điều này có thể hữu ích cho việc phân trang dữ liệu hoặc tìm các mục có phần tử con có giá trị cụ thể.

Cách sắp xếp dữ liệu truy vấn

Phần này giải thích cách sắp xếp dữ liệu theo từng phương thức sắp xếp trong lớp Query.

`OrderByChild`

Khi sử dụng OrderByChild() , dữ liệu chứa khoá con được chỉ định sẽ được sắp xếp như sau:

Các phần tử con có giá trị null cho khoá con được chỉ định sẽ xuất hiện đầu tiên.
Các phần tử con có giá trị false cho khoá con được chỉ định sẽ xuất hiện tiếp theo. Nếu nhiều phần tử con có giá trị false, chúng sẽ được sắp xếp theo thứ tự từ vựng theo khoá.
Các phần tử con có giá trị true cho khoá con được chỉ định xuất hiện tiếp theo. Nếu nhiều phần tử con có giá trị true, chúng sẽ được sắp xếp theo thứ tự từ vựng theo khoá.
Các phần tử con có giá trị số sẽ xuất hiện tiếp theo, được sắp xếp theo thứ tự tăng dần. Nếu nhiều phần tử con có cùng giá trị số cho nút con được chỉ định, chúng sẽ được sắp xếp theo khoá.
Các chuỗi xuất hiện sau các số và được sắp xếp theo thứ tự từ vựng tăng dần. Nếu nhiều phần tử con có cùng giá trị cho nút con được chỉ định, chúng sẽ được sắp xếp theo thứ tự từ vựng theo khoá.
Các đối tượng xuất hiện cuối cùng và được sắp xếp theo thứ tự từ vựng theo khoá theo thứ tự tăng dần.

`OrderByKey`

Khi sử dụng OrderByKey() để sắp xếp dữ liệu, dữ liệu sẽ được trả về theo thứ tự tăng dần theo khoá.

Các phần tử con có khoá có thể được phân tích cú pháp dưới dạng số nguyên 32 bit sẽ xuất hiện đầu tiên, được sắp xếp theo thứ tự tăng dần.
Các phần tử con có giá trị chuỗi làm khoá sẽ xuất hiện tiếp theo, được sắp xếp theo thứ tự từ vựng tăng dần.

`OrderByValue`

Khi sử dụng OrderByValue() , các phần tử con được sắp xếp theo giá trị của chúng. Tiêu chí sắp xếp giống như trong OrderByChild(), ngoại trừ việc giá trị của nút được sử dụng thay vì giá trị của một khoá con được chỉ định.

Truy xuất dữ liệu Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Trước khi bắt đầu

Truy xuất dữ liệu

Lấy DatabaseReference

Đọc dữ liệu một lần

Nghe sự kiện

Sự kiện ValueChanged

Sự kiện con

Sắp xếp và lọc dữ liệu

Sắp xếp dữ liệu

Lọc dữ liệu

Giới hạn số lượng kết quả

Lọc theo khoá hoặc giá trị

Cách sắp xếp dữ liệu truy vấn

OrderByChild

OrderByKey

OrderByValue

Truy xuất dữ liệu

`OrderByChild`

`OrderByKey`

`OrderByValue`