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 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:

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

  2. Hãy đảm bảo rằng bạn đã tạo tập dữ liệubảng BigQuery (có giản đồ) trước khi chèn hàng.

  3. Sử dụng Bảng điều khiển của GCP để tạo khoá cho tài khoản dịch vụ.

  4. 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ó
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ó

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ó.