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

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 từ proxy API bằng Chính sách 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. Đảm bảo rằng bạn đã tạo tập dữ liệubảng BigQuery (bằng 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 chứ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à một kho dữ liệu doanh nghiệp không máy chủ, có thể mở rộng, hỗ trợ truy vấn SQL với tốc độ cực 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ó 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 những hướng dẫn bắt đầu nhanh về Google BigQuery.

Thao tác

insert

Chèn trực tiếp một tập hợp các bản ghi dưới dạng tập dữ liệu vào BigQuery, trong đó có các hàng sẽ được 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>

Thông số yêu cầu

Thông số Nội dung 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 nội dung nào. Có.
hàng Các hàng cần chèn vào bảng. Mảng Không nội dung nào. Có.
bàn Tên của bảng nhận dữ liệu. Chuỗi Không nội dung nào. Có.

Phản hồi

Không nội dung nào.

listRows

Liệt kê các hàng trong bảng được xác đị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>

Thông số yêu cầu

Thông số Nội dung 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 dùng để liệt kê các hàng. Chuỗi Không nội dung nào. Có.
giới hạn Số hàng tối đa cần liệt kê. Số nguyên Không nội dung nào. Không.
startIndex Chỉ mục hàng mà tại đó sẽ bắt đầu danh sách. Số nguyên Không nội dung nào. Không.
bàn Mã của bảng được dùng để liệt kê các hàng. Chuỗi Không nội dung nào. Có.

Phản hồi

Mảng rows.

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
Thông số Nội dung mô tả Loại Mặc định Bắt buộc
hàng Một mảng các hàng được trả về từ yêu cầu. Mảng Không nội dung nào. Có.

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

Sử dụng các đoạn mã sau khi bạn định cấu hình và triển khai tiện ích này để sử dụng trong các 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.

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

Tài sản Nội dung mô tả Mặc định Bắt buộc
projectId Mã dự án GCP nơi chứa dữ liệu. Không nội dung nào. Có.
thông tin xác thực Khi được 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ụ của bạn. Khi được gửi qua API quản lý, giá trị này là giá trị được mã hoá base64 từ tệp khoá tài khoản dịch vụ. Không nội dung nào. Có.