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 1.0.0
Chèn hàng vào bảng BigQuery. Liệt kê các hàng trong bảng.
Điều kiện tiên quyết
Nội dung này cung cấp tài liệu 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 của một proxy API bằng chính sách ExtensionAnnotation (Chú thích tiện ích), bạn phải:
Đảm bảo rằng bạn đã bật BigQuery API cho tài khoản của mình.
Hãy đảm bảo rằng bạn đã tạo tập dữ liệu và bảng BigQuery (có giản đồ) trước khi chèn hàng.
Sử dụng Bảng điều khiển của GCP để tạo khoá cho tài khoản dịch vụ.
Sử dụng nội dung của tệp JSON của khoá thu được khi thêm và định cấu hình tiện ích bằng cách sử dụng tài liệu tham khảo về cấu hình.
Giới thiệu về Google BigQuery
Google BigQuery là kho dữ liệu doanh nghiệp có thể mở rộng, không máy chủ, cho phép truy vấn SQL với tốc độ cực nhanh bằng sức mạnh xử lý từ cơ sở hạ tầng của Google. Vì không có cơ sở hạ tầng để quản lý nên bạn có thể tập trung vào việc phân tích dữ liệu để tìm ra thông tin chi tiết có ý nghĩa bằng SQL quen thuộc mà không cần quản trị viên cơ sở dữ liệu.
Để xem phần giới thiệu thực tế, hãy thử một trong các hướng dẫn bắt đầu nhanh về Google BigQuery.
Thao tác
insert
Chèn một tập hợp các bản ghi dưới dạng tập dữ liệu trực tiếp vào BigQuery, với các hàng sẽ được chèn và mã tập dữ liệu/bảng.
Cú pháp
<Action>insert</Action>
<Input><![CDATA[{
"dataset" : dataset-to-insert,
"table" : table-to-receive-data,
"rows" : array-of-rows-to-insert
}]]></Input>
Ví dụ:
<Action>insert</Action>
<Input><![CDATA[{
"dataset" : "TestData",
"table" : "TestTable",
"rows" : [
{"technology":"CRISPR","inventorFirstName":"Jennifer","inventorLastName":"Doudna"},
{"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
{"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
]
}]]></Input>
Yêu cầu thông số
Thông số | Mô tả | Loại | Mặc định | Bắt buộc |
---|---|---|---|---|
tập dữ liệu | Mã của tập dữ liệu cần chèn vào BigQuery. | Chuỗi | Không có. | Có. |
hàng | Các hàng cần chèn vào bảng. | Mảng | Không có. | Có. |
bàn | Tên của bảng để nhận dữ liệu. | Chuỗi | Không có. | Có. |
Phản hồi
Không có.
listRows
Liệt kê các hàng trong bảng được chỉ định theo mã bảng và mã tập dữ liệu.
Cú pháp
<Action>listRows</Action>
<Input><![CDATA[{
"dataset" : ID-of-dataset-to-examine,
"limit" : maximum-rows-to-list,
"startIndex" : row-index-at-which-to-start-list
"table" : ID-of-table-to-examine
}]]></Input>
Ví dụ:
<Action>listRows</Action>
<Input><![CDATA[{
"dataset" : "TestData",
"limit" : 2,
"startIndex" : 1,
"table" : "TestTable"
}]]></Input>
Yêu cầu thông số
Thông số | Mô tả | Loại | Mặc định | Bắt buộc |
---|---|---|---|---|
tập dữ liệu | Mã của tập dữ liệu mà bạn muốn liệt kê hàng. | Chuỗi | Không có. | Có. |
giới hạn | Số hàng tối đa cần liệt kê. | Số nguyên | Không có. | STT |
startIndex | Chỉ mục hàng mà tại đó danh sách bắt đầu. | Số nguyên | Không có. | STT |
bàn | Mã của bảng cần liệt kê hàng. | Chuỗi | Không có. | Có. |
Phản hồi
Một mảng rows
.
{
"rows": [
{"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
{"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
]
}
Thông số | Mô tả | Loại | Mặc định | Bắt buộc |
---|---|---|---|---|
hàng | Mảng hàng được trả về từ yêu cầu. | Mảng | Không có. | Có. |
Tham chiếu cấu hình
Sử dụng mã sau 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 một tiện ích bằng bảng điều khiển Apigee, hãy xem bài viết Thêm và định cấu hình tiện ích.
Các thuộc tính tiện ích 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ó |
Các thuộc tính của gói tiện ích này
Chỉ định giá trị cho các thuộc tính cấu hình sau dành riêng cho tiện ích này.
Thuộc tính | Mô tả | Mặc định | Bắt buộc |
---|---|---|---|
projectId | Mã của dự án GCP có chứa dữ liệu. | Không có. | Có. |
thông tin xác thực | Khi được nhập vào bảng điều khiển của Apigee Edge, đây là nội dung của tệp khoá tài khoản dịch vụ của bạn. Khi được gửi qua API quản lý, giá trị này là một giá trị được mã hoá base64 được tạo từ tệp khoá tài khoản dịch vụ. | Không có. | Có. |