Trang này được dịch bởi Cloud Translation API.

Tiện ích Google Cloud Firestore

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X. thông tin

Phiên bản: 2.0.0

Tạo, đọc hoặc xoá dữ liệu trong cơ sở dữ liệu Cloud Firestore.

Nội dung này cung cấp thông tin tham khảo để định cấu hình và sử dụng tiện ích này. Trước khi sử dụng tiện ích này từ một proxy API, bạn phải:

Tạo một dự án Firebase tại bảng điều khiển của Firebase nơi lưu trữ dữ liệu của bạn.
Tạo khoá cho tài khoản dịch vụ.
Sử dụng nội dung của tệp JSON khoá thu được khi thêm và định cấu hình tiện ích bằng tệp tham chiếu cấu hình.

Giới thiệu về Cloud Firestore

Cloud Firestore lưu trữ dữ liệu trong các tài liệu, được lưu trữ trong các bộ sưu tập. Cloud Firestore sẽ tạo các bộ sưu tập và tài liệu ngầm ẩn trong lần đầu tiên bạn thêm dữ liệu vào tài liệu. Bạn không cần phải tạo bộ sưu tập hoặc tài liệu một cách rõ ràng.

Để biết thêm thông tin chung về Cloud Firestore, hãy xem phần Bắt đầu sử dụng Firestore trong tài liệu về Cloud Firestore.

Mẫu

Các ví dụ sau đây minh hoạ cách định cấu hình tính năng hỗ trợ cho các thao tác của tiện ích Cloud Firestore bằng cách sử dụng chính sách ExtensionCallout.

Thêm dữ liệu

Chính sách ExtensionCallout sau đây sẽ thêm một tài liệu có tên là freewill@example.com vào bộ sưu tập users. Thuộc tính data chỉ định các trường và giá trị của tài liệu mới.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Add-User-Data">
    <DisplayName>Add User Data</DisplayName>
    <Connector>my-cloud-firestore-extension</Connector>
    <Action>setDocument</Action>
    <Input><![CDATA[{
        "colName" : "users",
        "docName" : "freewill@example.com",
        "data" : {
            "firstName": "Will",
            "lastName": "Witman",
            "address": "270-8243 Tempor St.",
            "city": "Fort Worth",
            "region": "TX",
            "postalCode": "86519",
            "email": "freewill@example.com",
            "username": "freewill444"
        }
    }]]></Input>
</ConnectorCallout>

Lấy dữ liệu

Trong ví dụ này, chính sách ExtensionCallout truy xuất giá trị của tài liệu freewill@example.com từ tập hợp users. Tại đây, thuộc tính parsed của phần tử <Output> được đặt thành false để kết quả trả về sẽ là JSON dưới dạng chuỗi, thay vì JSON được phân tích cú pháp thành một đối tượng. Để biết thêm thông tin, hãy xem tài liệu tham khảo về phần tử <Output>.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Get-User-Data">
    <DisplayName>Get User Data</DisplayName>
    <Connector>straut-cloud-firestore-extension</Connector>
    <Action>getDocument</Action>
    <Input><![CDATA[{
        "colName" : "users",
        "docName" : "freewill@example.com"
    }]]></Input>
    <Output parsed="false">firestore.userdata.retrieved</Output>
</ConnectorCallout>

Chính sách Chỉ định thông báo sau đây sử dụng giá trị của biến lưu trữ phản hồi của tiện ích để chỉ định tải trọng phản hồi.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage name="CopyUserDataToResponse">
    <DisplayName>Copy User Data To Response</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{firestore.userdata.retrieved}</Payload>
    </Set>
</AssignMessage>

Xoá dữ liệu

Trong ví dụ này, chính sách ExtensionCallout sẽ xoá tài liệu lizzie@example.com khỏi bộ sưu tập users.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Delete-User-Data">
    <DisplayName>Delete User Data</DisplayName>
    <Connector>my-cloud-firestore-extension</Connector>
    <Action>deleteDocument</Action>
    <Input><![CDATA[{
        "colName" : "users",
        "docName" : "lizzie@example.com"
    }]]></Input>
</ConnectorCallout>

Truy vấn dữ liệu

Trong ví dụ này, chính sách ExtensionCallout truy vấn một tập hợp cities. Kết quả truy vấn được lọc theo các trường state và population. Tại đây, thuộc tính parsed của phần tử <Output> được đặt thành false để kết quả trả về sẽ là JSON dưới dạng chuỗi, thay vì JSON được phân tích cú pháp thành một đối tượng. Để biết thêm thông tin, hãy xem tài liệu tham khảo về phần tử <Output>.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Query-City-Data">
    <DisplayName>Query City Data</DisplayName>
    <Connector>cloud-firestore-extension</Connector>
    <Action>query</Action>
    <Input><![CDATA[{
        "colName":"cities",
        "queryArray":[
          ["state", "==", "CA"],
          ["population","<",1000000]
        ]
    }]]></Input>
    <Output parsed="false">compound-query-output</Output>
</ConnectorCallout>

Chính sách Chỉ định thông báo sau đây sử dụng giá trị của biến lưu trữ phản hồi của tiện ích để chỉ định tải trọng phản hồi.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage name="CopyQueryResultsToResponse">
    <DisplayName>Copy Query Results To Response</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{firestore.querydata.retrieved}</Payload>
    </Set>
</AssignMessage>

Thao tác

deleteDocument

Xoá một tài liệu khỏi bộ sưu tập.

Tham số yêu cầu

<Input><![CDATA[{
  "colName" : "firestore-collection-name",
  "docName" : "firestore-document-name"
}]]></Input>

Thông số	Mô tả	Loại	Mặc định	Bắt buộc
colName	Tên của bộ sưu tập chứa tài liệu cần xoá.	Chuỗi	Không có.	Có.
docName	Tên của tài liệu cần xoá.	Chuỗi	Không có.	Có.

Phản hồi

Không có.

getDocument

Truy xuất nội dung của một tài liệu.

Tham số yêu cầu

<Input><![CDATA[{
  "colName" : "firestore-collection-name",
  "docName" : "firestore-document-name"
}]]></Input>

Thông số	Mô tả	Loại	Mặc định	Bắt buộc
colName	Tên của bộ sưu tập để truy xuất tài liệu.	Chuỗi	Không có.	Có.
docName	Tên của tài liệu cần truy xuất.	Chuỗi	Không có.	Có.

Phản hồi

Đối tượng chứa nội dung của tài liệu ở định dạng JSON.

truy vấn

Truy vấn một bộ sưu tập theo các điều kiện chỉ định tạo thành một bộ lọc.

Tham số queryArray của hành động này chỉ định một mảng các mảng (hoặc một mảng trống nếu không có điều kiện lọc). Mỗi mảng bên trong chỉ định một điều kiện của bộ lọc. Nhiều mảng bên trong biểu thị nhiều điều kiện được kết hợp bằng toán tử AND.

Mỗi phần tử trong mảng điều kiện bên trong đại diện cho một phần của điều kiện. Mảng điều kiện luôn có 3 phần tử sau:

Phần tử bên trái chỉ định trường tập hợp.
Một phần tử ở giữa chỉ định toán tử.
Phần tử bên phải chỉ định giá trị trường tập hợp.

Ví dụ sau đây chỉ định hai mảng điều kiện để lọc dựa trên các trường state và population của tập hợp:

<Input><![CDATA[{
  "colName":"cities",
  "queryArray":[
    ["state", "==", "CA"],
    ["population","<",1000000]
  ]
}]]></Input>

Trong thời gian chạy, hành động này được diễn giải là một truy vấn như sau:

Chọn tất cả các thành phố có tiểu bang = "CA" và dân số < 1000000

Một truy vấn có nhiều điều kiện phải được hỗ trợ trong Cloud Firestore bằng chỉ mục tổng hợp. Để biết thêm thông tin, hãy xem phần Các loại chỉ mục trong Cloud Firestore.

Tham số yêu cầu

Cú pháp

<Input><![CDATA[{
  "colName" : "firestore-collection-name",
  "queryArray" : "queryArray": query-condition-array
}]]></Input>

Ví dụ:

Trong ví dụ này, tham số queryArray chỉ định hai điều kiện để lọc bộ sưu tập cities do tham số colName chỉ định.

Chỉ mục tổng hợp phải hỗ trợ truy vấn có nhiều điều kiện trong Cloud Firestore. Để biết thêm thông tin, hãy xem phần Các loại chỉ mục trong Cloud Firestore.

<Input><![CDATA[{
  "colName":"cities",
  "queryArray":[["state", "==", "CA"],["population","<",1000000]]
}]]></Input>

Trong thời gian chạy, hành động này được diễn giải là một truy vấn như sau:

Chọn tất cả các thành phố có tiểu bang = "CA" và dân số < 1000000

Thông số	Mô tả	Loại	Mặc định	Bắt buộc
colName	Tên của bộ sưu tập cần truy vấn.	Chuỗi	Không có.	Có.
queryArray	Một mảng các mảng điều kiện cùng nhau chỉ định các phần của một bộ lọc. Chỉ định một mảng trống để bỏ qua các điều kiện (không phải kết quả lọc).	Mảng	Không có.	Có.

Phản hồi

Đối tượng chứa nội dung của tài liệu ở định dạng JSON.

setDocument

Sao chép một tài liệu vào một bộ sưu tập Cloud Firestore. Nếu tài liệu đã tồn tại trong bộ sưu tập, thao tác này sẽ ghi đè tài liệu đó.

Tham số yêu cầu

<Input><![CDATA[{
  "colName" : "firestore-collection-name",
  "docName" : "firestore-document-name",
  "data" : "data-to-copy"
}]]></Input>

Thông số	Mô tả	Loại	Mặc định	Bắt buộc
colName	Tên của bộ sưu tập để tạo tài liệu.	Chuỗi	Không có.	Có.
docName	Tên của tài liệu mà bạn muốn sao chép `data`.	Chuỗi	Không có.	Có.
khác	Dữ liệu cần sao chép vào `docName`. Đây phải là một đối tượng JSON hợp lệ. Không hỗ trợ mảng.	Đối tượng	Không có.	STT

Phản hồi

Không có.

Tài liệu tham khảo về cấu hình

Hãy sử dụng nội dung sau đây khi bạn định cấu hình và triển khai tiện ích này để sử dụng trong proxy API. Để biết các bước định cấu hình tiện ích bằng bảng điều khiển Apigee, hãy xem phần Thêm và định cấu hình tiện ích.

Các thuộc tính mở rộng phổ biến

Các thuộc tính sau có sẵn cho mỗi tiện ích.

Tài sản	Mô tả	Mặc định	Bắt buộc
`name`	Tên mà bạn đang đặt cho cấu hình của tiện ích này.	Không có	Có
`packageName`	Tên của gói tiện ích do Apigee Edge cung cấp.	Không có	Có
`version`	Số phiên bản của gói tiện ích mà bạn đang định cấu hình tiện ích.	Không có	Có
`configuration`	Giá trị cấu hình cụ thể cho tiện ích bạn đang thêm. Xem Thuộc tính cho gói tiện ích này	Không có	Có

Thuộc tính cho gói tiện ích này

Thuộc tính	Mô tả	Mặc định	Bắt buộc
firestoreDB	URL đến cơ sở dữ liệu Cloud Firestore mà tiện ích này sẽ sử dụng khi tạo yêu cầu. URL này thường có dạng `https://DATABASE_NAME.firebaseio.com`.	Không có.	Có.
thông tin xác thực	Khi nhập vào bảng điều khiển Apigee Edge, đây là nội dung của tệp khoá mà bạn đã tạo bằng hướng dẫn của Firebase. Khi được gửi qua API quản lý, đây là một giá trị được mã hoá base64 được tạo từ tệp khoá.	Không có.	Có.