افزونه Google BigQuery

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

نسخه 2.0.2

ردیف‌ها را در جدول BigQuery درج کنید. ردیف‌های جدول را فهرست کنید.

پیش‌نیازها

این محتوا مرجعی برای پیکربندی و استفاده از این افزونه ارائه می‌دهد. قبل‌از استفاده از افزونه از یک پراکسی API بااستفاده از خط‌مشی ExtensionCallout، باید:

  1. مطمئن شوید که BigQuery API را برای حسابتان فعال کرده‌اید.

  2. قبل‌از تلاش برای درج ردیف‌ها، مطمئن شوید که مجموعه داده و جدول BigQuery (با طرح) ایجاد کرده‌اید.

  3. از «کنسول Google Cloud» برای تولید کلید حساب سرویس استفاده کنید.

  4. از محتوای فایل JSON کلید حاصل هنگام افزودن و پیکربندی افزونه بااستفاده از مرجع پیکربندی استفاده کنید.

درباره Google BigQuery

Google BigQuery یک انبار داده سازمانی مقیاس‌پذیر و بدون سرور است که بااستفاده از قدرت پردازش زیرساخت Google، پُرسمان‌های SQL فوق‌سریع را ممکن می‌کند. ازآنجایی‌که زیرساختی برای مدیریت وجود ندارد، می‌توانید بدون نیاز به سرپرست پایگاه داده، روی تجزیه‌وتحلیل داده‌ها برای یافتن اطلاعات آماری معنادار بااستفاده از 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 شناسه پروژه Google Cloud که داده‌ها در آن قرار دارد. هیچ‌کدام. بله.
اطلاعات اعتباری وقتی در کنسول Apigee Edge وارد می‌شود، این محتوای فایل کلید حساب سرویس شما است. وقتی بااستفاده از «میانای برنامه‌سازی کاربردی مدیریت» ارسال می‌شود، مقدار رمزگذاری‌شده با base64 است که از فایل کلید حساب سرویس تولید می‌شود. هیچ‌کدام. بله.