ส่วนขยาย Google BigQuery

คุณกําลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X
info

เวอร์ชัน 2.0.0

แทรกแถวลงในตาราง BigQuery แสดงรายการแถวจากตาราง

ข้อกำหนดเบื้องต้น

เนื้อหานี้ให้ข้อมูลอ้างอิงสำหรับการกำหนดค่าและการใช้ส่วนขยายนี้ คุณต้องดำเนินการต่อไปนี้ก่อนใช้ส่วนขยายจากพร็อกซี API โดยใช้นโยบาย ExtensionCallout

  1. ตรวจสอบว่าคุณได้เปิดใช้ BigQuery API สําหรับบัญชีแล้ว

  2. ตรวจสอบว่าคุณได้สร้างdatasetและตาราง BigQuery (ที่มีสคีมา) แล้วก่อนที่จะพยายามแทรกแถว

  3. ใช้คอนโซล GCP เพื่อสร้างคีย์สําหรับบัญชีบริการ

  4. ใช้เนื้อหาของไฟล์คีย์ JSON ที่ได้เมื่อเพิ่มและกําหนดค่าส่วนขยายโดยใช้ข้อมูลอ้างอิงการกําหนดค่า

เกี่ยวกับ Google BigQuery

Google BigQuery เป็นคลังข้อมูลสำหรับองค์กรแบบ Serverless ที่ปรับขนาดได้ ซึ่งช่วยให้การค้นหาด้วย SQL รวดเร็วทันใจโดยใช้กำลังการประมวลผลของโครงสร้างพื้นฐานของ Google เนื่องจากไม่มีโครงสร้างพื้นฐานที่ต้องจัดการ คุณจึงมุ่งเน้นที่การวิเคราะห์ข้อมูลเพื่อค้นหาข้อมูลเชิงลึกที่มีประโยชน์ได้โดยใช้ SQL ที่คุ้นเคยโดยไม่ต้องมีผู้ดูแลระบบฐานข้อมูล

หากต้องการดูการแนะนำแบบลงมือปฏิบัติ ให้ลองใช้การเริ่มต้นใช้งาน Google BigQuery ฉบับย่อ

การทำงาน

Insert

แทรกชุดระเบียนเป็นชุดข้อมูลใน BigQuery โดยตรง พร้อมแถวที่จะแทรกและรหัสชุดข้อมูล/ตาราง

ไวยากรณ์

<Action>insert</Action>
<Input><![CDATA[{
  "dataset" : dataset-to-insert,
  "table" : table-to-receive-data,
  "rows" : array-of-rows-to-insert
}]]></Input>

ตัวอย่าง

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

พารามิเตอร์คำขอ

พารามิเตอร์ คำอธิบาย ประเภท ค่าเริ่มต้น ต้องระบุ
ชุดข้อมูล รหัสของชุดข้อมูลที่จะแทรกลงใน BigQuery สตริง ไม่มี ได้
แถว แถวที่จะแทรกลงในตาราง อาร์เรย์ ไม่มี ได้
โต๊ะ ชื่อตารางที่จะรับข้อมูล สตริง ไม่มี ได้

การตอบกลับ

ไม่มี

listRows

แสดงรายการแถวในตารางที่ระบุโดยรหัสตารางและรหัสชุดข้อมูล

ไวยากรณ์

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

ตัวอย่าง

<Action>listRows</Action>
<Input><![CDATA[{
  "dataset" : "TestData",
  "limit" : 2,
  "startIndex" : 1,
  "table" : "TestTable"
}]]></Input>

พารามิเตอร์คำขอ

พารามิเตอร์ คำอธิบาย ประเภท ค่าเริ่มต้น ต้องระบุ
ชุดข้อมูล รหัสของชุดข้อมูลที่จะแสดงรายการแถว สตริง ไม่มี ได้
ขีดจำกัด จำนวนแถวสูงสุดที่จะแสดง จำนวนเต็ม ไม่มี ไม่
startIndex ดัชนีแถวที่จะเริ่มต้นรายการ จำนวนเต็ม ไม่มี ไม่
โต๊ะ รหัสของตารางที่จะแสดงรายการแถว สตริง ไม่มี ได้

การตอบกลับ

อาร์เรย์ rows

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
พารามิเตอร์ คำอธิบาย ประเภท ค่าเริ่มต้น ต้องระบุ
แถว อาร์เรย์ของแถวที่แสดงผลจากคําขอ อาร์เรย์ ไม่มี ได้

ข้อมูลอ้างอิงการกําหนดค่า

ใช้ข้อมูลต่อไปนี้เมื่อกําหนดค่าและติดตั้งใช้งานส่วนขยายนี้เพื่อใช้ในพร็อกซี API ดูขั้นตอนการกำหนดค่าส่วนขยายโดยใช้คอนโซล Apigee ได้ที่การเพิ่มและกําหนดค่าส่วนขยาย

พร็อพเพอร์ตี้ส่วนขยายทั่วไป

พร็อพเพอร์ตี้ต่อไปนี้มีอยู่ในส่วนขยายทุกรายการ

พร็อพเพอร์ตี้ คำอธิบาย ค่าเริ่มต้น ต้องระบุ
name ชื่อที่คุณกําหนดให้การกําหนดค่านี้ของส่วนขยาย ไม่มี ได้
packageName ชื่อแพ็กเกจส่วนขยายที่ระบุโดย Apigee Edge ไม่มี ได้
version หมายเลขเวอร์ชันของแพ็กเกจส่วนขยายที่คุณกําหนดค่าส่วนขยาย ไม่มี ได้
configuration ค่าการกําหนดค่าเฉพาะสําหรับส่วนขยายที่คุณกําลังเพิ่ม ดูพร็อพเพอร์ตี้สําหรับแพ็กเกจส่วนขยายนี้ ไม่มี ได้

พร็อพเพอร์ตี้ของแพ็กเกจส่วนขยายนี้

ระบุค่าสำหรับพร็อพเพอร์ตี้การกําหนดค่าต่อไปนี้ที่เจาะจงสําหรับส่วนขยายนี้

พร็อพเพอร์ตี้ คำอธิบาย ค่าเริ่มต้น ต้องระบุ
projectId รหัสของโปรเจ็กต์ GCP ที่มีข้อมูล ไม่มี ได้
ข้อมูลเข้าสู่ระบบ เมื่อป้อนในคอนโซล Apigee Edge เนื้อหาของไฟล์คีย์บัญชีบริการจะมีลักษณะดังนี้ เมื่อส่งผ่าน Management API ค่าจะเป็นค่าที่เข้ารหัส Base64 ที่สร้างขึ้นจากไฟล์คีย์ของบัญชีบริการ ไม่มี ได้