Tiện ích Google BigQuery

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

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 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 từ một proxy API bằng chính sách ExtensionCallout, bạn phải:

  1. Đảm bảo rằng bạn đã bật BigQuery API cho tài khoản của mình.

  2. Đảm bảo rằng bạn đã tạo datasetbảng BigQuery (có giản đồ) trước khi chèn hàng.

  3. Sử dụng GCP Console để tạo khoá cho tài khoản dịch vụ.

  4. 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ề Google BigQuery

Google BigQuery là một kho dữ liệu doanh nghiệp không máy chủ, có thể mở rộng, cho phép truy vấn SQL siêu nhanh bằng cách sử dụng sức mạnh xử lý của cơ sở hạ tầng của Google. Vì không cần quản lý cơ sở hạ tầng, bạn có thể tập trung vào việc phân tích dữ liệu để tìm thông tin chi tiết có ý nghĩa bằng cách sử dụng SQL quen thuộc mà không cần quản trị viên cơ sở dữ liệu.

Để tìm hiểu cách thực hành, hãy thử một trong các hướng dẫn nhanh về Google BigQuery.

Thao tác

insert

Chèn một tập hợp 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 cần chèn và mã nhận dạng 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>

Tham số yêu cầu

Thông số Mô tả Loại Mặc định Bắt buộc
tập dữ liệu Mã nhận dạng 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 bằng mã nhận dạng bảng và mã nhận dạng 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>

Tham số yêu cầu

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 để liệt kê các hàng. Chuỗi Không có. Có.
giới hạn Số hàng tối đa để liệt kê. Số nguyên Không có. STT
startIndex Chỉ mục hàng bắt đầu danh sách. Số nguyên Không có. STT
bàn Mã của bảng để liệt kê các 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 các hàng được trả về từ yêu cầu. Mảng Không có. 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ó
packageName Tên của gói tiện ích do Apigee Edge cung cấp. Không 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ó
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ó

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

Chỉ định giá trị cho các thuộc tính cấu hình sau đây 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 chứa dữ liệu. 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á tài khoản dịch vụ. 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á tài khoản dịch vụ. Không có. Có.