Bắt đầu sử dụng Firebase Data Connect

Trong phần bắt đầu nhanh này, bạn sẽ tìm hiểu cách tạo Firebase Data Connect trong ứng dụng.

  • Thêm Firebase Data Connect vào dự án Firebase.
  • Thiết lập môi trường phát triển, bao gồm cả Visual Studio Tiện ích mã hoạt động với phiên bản phát hành chính thức.
  • Sau đó, chúng tôi sẽ hướng dẫn bạn cách:
    • Tạo giản đồ cho ứng dụng đánh giá phim và triển khai cho bản phát hành chính thức.
    • Xác định truy vấn và đột biến cho giản đồ.
    • Tạo SDK có kiểu mạnh và sử dụng các SDK đó trong ứng dụng
    • Triển khai giản đồ, truy vấn và dữ liệu cuối cùng cho môi trường phát hành chính thức.

Điều kiện tiên quyết

Để sử dụng tính năng bắt đầu nhanh này trong môi trường địa phương, bạn cần có:

Kết nối với dự án Firebase

  1. Tạo một dự án Firebase nếu bạn chưa tạo.
    1. Trong bảng điều khiển Firebase, hãy nhấp vào Thêm dự án rồi làm theo hướng dẫn trên màn hình.
  2. Chuyển đến phần Data Connect trên bảng điều khiển của Firebase và làm theo quy trình thiết lập sản phẩm.
  3. Nâng cấp dự án lên gói Blaze. Thao tác này cho phép bạn tạo một Cloud SQL cho thực thể PostgreSQL.

  4. Chọn một vị trí cho cơ sở dữ liệu CloudSQL cho PostgreSQL.

  5. Ghi lại tên cũng như mã dự án, dịch vụ và cơ sở dữ liệu để xác nhận sau.

  6. Làm theo quy trình thiết lập còn lại, rồi nhấp vào Xong.

Chọn và thiết lập môi trường phát triển

Data Connect hỗ trợ 2 trải nghiệm phát triển để phát triển:

  • Nếu bạn là nhà phát triển Kotlin Android, iOS, Flutter hoặc web, bạn có thể dùng tính năng phát triển mã VS để thiết kế cũng như kiểm thử giản đồ và hoạt động cục bộ trong khi kết nối với phiên bản Cloud SQL cho PostgreSQL.
  • Nếu là nhà phát triển web, bạn có thể sử dụng IDX Development để tạo nguyên mẫu trong không gian làm việc IDX bằng cách sử dụng một mẫu IDX được định cấu hình sẵn với PostgreSQL, Tiện ích VS Code với trình mô phỏng Data Connect và ứng dụng khởi động nhanh mã cho bạn. Bạn có thể tìm thêm thông tin tại Trang web Project IDX.

Phần hướng dẫn nhanh này tập trung vào quy trình phát triển tiện ích VS Code. Cách tiếp tục:

  1. Tạo một thư mục mới cho dự án cục bộ của bạn.
  2. Mở Mã VS trong thư mục mới.
  3. Cài đặt tiện ích Firebase Data Connect từ Visual Studio Code Marketplace.

Thiết lập dự án cục bộ

Cài đặt CLI theo hướng dẫn thông thường. Nếu bạn đã cài đặt npm, hãy chạy lệnh sau:

npm install -g firebase-tools

Thiết lập thư mục dự án

Để thiết lập dự án cục bộ, hãy khởi chạy thư mục dự án.

Trong bảng điều khiển bên trái Mã VS, hãy nhấp vào biểu tượng Firebase để mở giao diện người dùng tiện ích Mã VS Firebase.

  1. Nhấp vào nút Sign in with Google (Đăng nhập bằng Google).
  2. Nhấp vào nút Kết nối dự án Firebase rồi chọn dự án bạn đã tạo trước đó trong bảng điều khiển.
  3. Nhấp vào nút Run firebase init (Chạy firebase init).
  4. Nếu dự án của bạn nằm trong Gói linh hoạt khi được nhắc "Bạn có muốn định cấu hình tài nguyên phụ trợ ngay bây giờ không?", trả lời "Có".
  5. Nhấp vào nút Start emulators (Bắt đầu trình mô phỏng).

Tạo giản đồ

Trong thư mục dự án Firebase, trong tệp /dataconnect/schema/schema.gql, hãy bắt đầu xác định giản đồ GraphQL bao gồm các bộ phim.

Phim

Trong Data Connect, các trường GraphQL được liên kết với các cột. Loại Movieid, title, imageUrlgenre. Data Connect nhận dạng các kiểu dữ liệu gốc StringUUID.

Sao chép đoạn mã sau hoặc huỷ nhận xét các dòng tương ứng trong tệp.

# File `/dataconnect/schema/schema.gql`

# By default, a UUID id key will be created by default as primary key.
type Movie @table {
  id: UUID! @default(expr: "uuidV4()")
  title: String!
  imageUrl: String!
  genre: String
}

MovieMetadata

Giờ đây, bạn đã có phim, bạn có thể lập mô hình siêu dữ liệu phim.

Sao chép đoạn mã sau hoặc huỷ nhận xét các dòng tương ứng trong tệp.

# Movie - MovieMetadata is a one-to-one relationship
type MovieMetadata @table {
  # This time, we omit adding a primary key because
  # you can rely on Data Connect to manage it.

  # @unique indicates a 1-1 relationship
  movie: Movie! @unique
  # movieId: UUID <- this is created by the above reference
  rating: Float
  releaseYear: Int
  description: String
}

Xin lưu ý rằng trường movie được liên kết với một loại Movie. Data Connect hiểu rằng đây là mối quan hệ giữa MovieMovieMetadata, đồng thời sẽ quản lý mối quan hệ này cho bạn.

Tìm hiểu thêm về giản đồ Data Connect trong tài liệu

Triển khai giản đồ vào môi trường thực tế

Nếu đang sử dụng tiện ích Firebase VS Code để làm việc với cơ sở dữ liệu chính thức, bạn cần triển khai giản đồ trước khi tiếp tục. Sau khi triển khai giản đồ vào cơ sở dữ liệu chính thức, bạn sẽ có thể xem giản đồ trên bảng điều khiển.

  1. Bạn có thể sử dụng tiện ích Data Connect VS Code để triển khai.
    • Trong giao diện người dùng của tiện ích, trong bảng điều khiển Firebase Data Connect, hãy nhấp vào Triển khai cho phiên bản chính thức.
  2. Bạn có thể cần xem xét các thay đổi về giản đồ và phê duyệt các nội dung sửa đổi có thể gây hại. Bạn sẽ được nhắc:
    • Xem xét các thay đổi đối với giản đồ bằng cách sử dụng firebase dataconnect:sql:diff
    • Khi bạn hài lòng với các thay đổi, hãy áp dụng các thay đổi đó bằng cách sử dụng flow do firebase dataconnect:sql:migrate bắt đầu.

Thêm dữ liệu vào bảng

Trong bảng điều khiển Trình soạn thảo mã VS, bạn có thể thấy các nút CodeLens xuất hiện trên Các loại GraphQL trong /dataconnect/schema/schema.gql. Vì bạn đã triển khai cho giai đoạn sản xuất, bạn có thể sử dụng thuộc tính Thêm dữ liệu và Các nút Run (Phát hành chính thức) sẽ thêm dữ liệu vào cơ sở dữ liệu của bạn trong phần phụ trợ.

Cách thêm bản ghi vào bảng Movie:

  1. Trong schema.gql, hãy nhấp vào nút Thêm dữ liệu phía trên loại Movie .
    Nút Thêm dữ liệu của Kính lúp mã cho Firebase Data Connect
  2. Trong tệp Movie_insert.gql được tạo, dữ liệu mã cứng cho bốn trường.
  3. Nhấp vào nút Run (Production) (Chạy (Bản chính thức)).
    Nút Chạy của Code Lens cho Firebase Data Connect

Cách nhanh chóng xác minh dữ liệu đã được thêm:

  1. Quay lại schema.gql, nhấp vào nút Đọc dữ liệu.
  2. Trong tệp Movie_read.gql thu được, hãy nhấp vào nút Chạy (Phát hành công khai) để thực thi truy vấn.

Tìm hiểu thêm về các trường hợp đột biến của Kết nối dữ liệu trong tài liệu

Xác định truy vấn của bạn

Giờ là phần thú vị, truy vấn. Là một nhà phát triển, bạn đã quen với việc viết truy vấn SQL thay vì truy vấn GraphQL, vì vậy, việc này có thể hơi khác một chút lúc đầu. Tuy nhiên, GraphQL ngắn gọn và an toàn về loại hơn nhiều so với SQL thô. Và Mã VS của chúng tôi tiện ích giúp quá trình phát triển trở nên dễ dàng.

Bắt đầu chỉnh sửa tệp /dataconnect/connector/queries.gql. Nếu bạn muốn nhận tất cả phim, hãy sử dụng truy vấn như sau.

# File `/dataconnect/connector/queries.gql`

# @auth() directives control who can call each operation.
# Anyone should be able to list all movies, so the auth level
# is set to PUBLIC
query ListMovies @auth(level: PUBLIC) {
  movies {
    id
    title
    imageUrl
    genre
  }
}

Thực thi truy vấn bằng cách sử dụng nút CodeLens lân cận.

Tìm hiểu thêm về truy vấn Data Connect trong tài liệu

Tạo SDK và sử dụng SDK trong ứng dụng

  1. Nhấp vào nút Thêm SDK vào ứng dụng.
  2. Trong hộp thoại xuất hiện, hãy chọn thư mục chứa mã cho ứng dụng của mình. Data Connect. Mã SDK sẽ được tạo và đã lưu ở đó.

  3. Chọn nền tảng ứng dụng, sau đó lưu ý rằng mã SDK sẽ được tạo ngay trong thư mục bạn đã chọn.

Tìm hiểu cách sử dụng SDK đã tạo để gọi các truy vấn và đột biến từ ứng dụng khách (web, Android, iOS, Flutter).

Triển khai giản đồ và truy vấn vào môi trường sản xuất

Bạn đã thực hiện một vòng lặp phát triển. Giờ đây, bạn có thể triển khai giản đồ, dữ liệu và truy vấn cho máy chủ bằng giao diện người dùng tiện ích Firebase hoặc CLI Firebase, giống như cách bạn đã làm với giản đồ.

Nếu bạn sử dụng tiện ích Firebase VS Code để triển khai, hãy nhấp vào nút Deploy to production (Triển khai lên phiên bản chính thức).

Sau khi triển khai, hãy chuyển đến bảng điều khiển Firebase để xác minh giản đồ, hoạt động và dữ liệu đã được tải lên đám mây. Bạn cũng có thể xem giản đồ và chạy các thao tác trên bảng điều khiển. Phiên bản Cloud SQL cho thực thể PostgreSQL sẽ được cập nhật với phiên bản cuối cùng đã triển khai giản đồ và dữ liệu tạo ra.

Tìm hiểu thêm về cách sử dụng trình mô phỏng Data Connect trong tài liệu

Các bước tiếp theo

Xem lại dự án đã triển khai và khám phá các công cụ khác: