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:

• Thêm Firebase Data Connect vào dự án Firebase của bạn.
• 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 một thực thể 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 email và triển khai ứng dụng chính thức.
  • Xác định truy vấn và trường hợp đột biến cho giản đồ của bạn.
  • Triển khai nguyên mẫu hoàn chỉnh vào kênh phát hành công khai.

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

Để sử dụng tính năng bắt đầu nhanh này, bạn cần có:

• Linux, macOS hoặc Windows
• Visual Studio Code

Kết nối với dự án Firebase của bạn

1. Tạo một dự án Firebase nếu bạn chưa tạo.
   1. Trong bảng điều khiển của Firebase, hãy nhấp vào Thêm dự án, sau đó làm theo hướng dẫn trên màn hình.

2. Nâng cấp dự án của bạn lên Gói linh hoạt. Thao tác này cho phép bạn tạo một Cloud SQL cho thực thể PostgreSQL.

3. Chuyển đến mục Kết nối dữ liệu trong bảng điều khiển của Firebase và làm theo quy trình thiết lập sản phẩm.

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 để tạo nguyên mẫu:

• Nếu là nhà phát triển Kotlin Android hoặc web, bạn có thể sử dụng VS Code phát triển để tạo giản đồ nguyên mẫu và hoạt động cục bộ đồng thời kết nối với Cloud SQL cho thực thể 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à mã bắt đầu nhanh cho bạn. Bạn có thể tìm thêm thông tin tại Trang web Project IDX.

Bước bắt đầu nhanh này tập trung vào quy trình phát triển tiện ích Mã VS. Để tiếp tục, hãy làm như sau:

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. Tải tiện ích xuống, được đóng gói dưới dạng gói VSIX, từ Bộ nhớ Firebase.

4. Trong VS Code, từ trình đơn Chế độ xem, hãy chọn Tiện ích.

5. Trên thanh tiêu đề của bảng điều khiển Tiện ích, hãy nhấp vào biểu tượng trình đơn more_horiz, rồi theo dõi Cài đặt từ VSIX....

Nếu muốn, bạn có thể cài đặt cơ sở dữ liệu PostgreSQL cục bộ để phát triển cục bộ với trình mô phỏng Data Connect. Thiết lập này được đề cập ở cuối hướng dẫn bắt đầu nhanh này.

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

Cài đặt CLI, làm theo các hướng dẫn thông thường. Nếu bạn có npm đã cài đặt, 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ở Firebase VS Giao diện người dùng của phần mở rộng về mã.

Trong giao diện người dùng của tiện ích Firebase:

1. Hãy đảm bảo rằng bạn đã đăng nhập.
2. Nhấp vào nút Run firebase init (Chạy init Firebase).
3. Kiểm tra thẻ Terminal (Thiết bị đầu cuối) trong Bảng điều khiển phía dưới Mã VS để tìm lời nhắc.
4. Chọn Kết nối dữ liệu làm tính năng để sử dụng trong thư mục này.
5. Khi được nhắc, hãy cung cấp mã dự án, dịch vụ và cơ sở dữ liệu của Dự án Data Connect mà bạn đã tạo trước đó trong bảng điều khiển.

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 người dùng và email.

Người dùng

Trong Data Connect, các trường trong GraphQL được liên kết với các cột. Người dùng có uid, name và email address. Data Connect nhận ra một số loại dữ liệu gốc: String và Date.

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`

type User @table(key: "uid") {
   uid: String!
   name: String!
   address: String!
}

Theo mặc định, Firebase Data Connect sẽ thêm khoá id của UUID nếu không có khoá nào đã cung cấp. Tuy nhiên, trong trường hợp này, bạn muốn uid của tôi là khoá chính. mà bạn có thể thực hiện thông qua lệnh @table(key: "uid").

Email

Giờ đây khi đã có người dùng, bạn có thể lập mô hình email. Tại đây, bạn có thể thêm trường (hoặc cột) cho dữ liệu email. Lần này, chúng ta bỏ qua bước thêm khoá chính vì bạn có thể dùng Data Connect để quản lý.

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

type Email @table {
   subject: String!
   sent: Date!
   text: String!
   from: User!
}

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

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

Nếu bạn đang sử dụng tiện ích Firebase VS để 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 triển khai giản đồ cho cơ sở dữ liệu sản xuất, bạn sẽ có thể xem giản đồ trên bảng điều khiển.

1. Bạn có thể sử dụng phần mở rộng Mã Firebase VS để triển khai.
   • Trong giao diện người dùng tiện ích, ở bảng điều khiển Kết nối dữ liệu Firebase, hãy nhấp vào Triển khai.
2. Bạn có thể cần phải xem xét các thay đổi đối với giản đồ và phê duyệt nội dung có khả năng phá hoại sửa đổ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 quy trình được bắt đầu bằng firebase dataconnect:sql:migrate.

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 giản đồ cho phiên bản chính thức, bạn có thể sử dụng Thêm dữ liệu và Chạy (Sản xuất) các nút thêm dữ liệu vào cơ sở dữ liệu của bạn trên phần phụ trợ.

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

1. Trong schema.gql, hãy nhấp vào nút Thêm dữ liệu phía trên loại User .
   
2. Trong tệp User_insert.gql được tạo, dữ liệu mã cứng cho 3 trường.
3. Nhấp vào nút Run (Phát hành công khai).
   
4. Lặp lại các bước trước đó để thêm một bản ghi vào bảng Email, cung cấp uid của người dùng trong trường fromUid, như được nhắc trong Đột biến Email_insert.

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

Phần thú vị nhất là truy vấn. Là một nhà phát triển, bạn đã quen viết SQL thay vì truy vấn GraphQL, nên thoạt đầu bạn có thể thấy hơi khác. Tuy nhiên, GraphQL ngắn gọn và an toàn về kiểu hơn nhiều so với SQL thô. Và Mã VS của chúng tôi 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/default-connector/queries.gql. Nếu bạn muốn để nhận tất cả email, hãy dùng một truy vấn như thế này.

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

query ListEmails @auth(level: NO_ACCESS) {
  emails {
    id, subject, text, sent
    from {
      name
    }
  }
}

Thực thi truy vấn bằng cách sử dụng nút CodeLens ở gần.

Một tính năng thực sự thú vị ở đây là khả năng xử lý mối quan hệ như một biểu đồ. Vì Email có trường from tham chiếu đến Người dùng, bạn có thể lồng ghép vào trường này và nhận lại thông tin về người dùng.

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

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

Nếu bạn sử dụng tiện ích Firebase VS để triển khai, hãy nhấp vào Triển khai tất cả .

Sau khi được triển khai, bạn sẽ có thể xem và chạy các hoạt động của mình trên bảng điều khiển của Google. Dịch vụ Data Connect của bạn sẽ sẵn sàng xử lý các hoạt động từ khách hàng. Phiên bản Cloud SQL cho thực thể PostgreSQL sẽ được cập nhật với giản đồ và dữ liệu được tạo cuối cùng được triển khai.

(Không bắt buộc) Cài đặt PostgreSQL cục bộ

Việc cài đặt PostgreSQL cục bộ và tích hợp với trình mô phỏng cho phép bạn nguyên mẫu trong môi trường phát triển cục bộ hoàn toàn.

Bạn có thể cài đặt một thực thể mới của PostgreSQL hoặc sử dụng một thực thể hiện có.

Cài đặt PostgreSQL

Cài đặt PostgreSQL phiên bản 15.x theo hướng dẫn dành cho nền tảng của bạn.

• macOS. Tải và cài đặt Postgres.app.
• Windows: Sử dụng trình cài đặt EDB trên trang tải xuống PostgreSQL.
• Docker: Kéo và chạy pgvector/pgvector:15 hình ảnh, hỗ trợ cả PostgreSQL 15.x và vectơ.
• Linux: Bạn nên sử dụng Docker với hình ảnh trước, nhưng bạn cũng có thể làm theo hướng dẫn thay thế đối với những bản phân phối phổ biến.

Ghi chú đầu ra tên máy chủ, cổng, tên người dùng và mật khẩu và các tham số liên quan trong khi trình tự cài đặt.

Để kết nối với phiên bản PostgreSQL, trình mô phỏng cần:

• Các thông số cấu hình thiết lập này
• Tên cơ sở dữ liệu trong dataconnect.yaml và một tên tương ứng cơ sở dữ liệu được khởi tạo trong thực thể cục bộ của bạn.

Sử dụng thực thể PostgreSQL cục bộ

Bạn có thể sử dụng một thực thể PostgreSQL cục bộ hiện có bằng cách cập nhật Chế độ cài đặt trình mô phỏng Data Connect.

firebase setup:emulators:dataconnect

Khi được nhắc, hãy nhập chuỗi kết nối PostgreSQL theo định dạng sau: postgresql://postgresusername:postgrespassword@localhost:5432/postgresdatabase?sslmode=disable.

Để biết thêm thông tin về chuỗi kết nối, hãy tham khảo Tài liệu về PostgreSQL.

Kết nối với thực thể PostgreSQL cục bộ

Với cấu hình này được hoàn tất, để kết nối với cơ sở dữ liệu cục bộ của bạn:

1. Trong Mã VS, trong bảng điều khiển bên trái, hãy nhấp vào biểu tượng Firebase để mở Giao diện người dùng của phần mở rộng về mã Firebase và mã.
2. Nhấp vào nút Kết nối với PostgreSQL cục bộ.

Các bước tiếp theo