برنامه افزودنی Google BigQuery

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

نسخه ۲.۰.۲

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

پیش‌نیازها

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

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

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

  3. از کنسول گوگل کلود برای ایجاد کلید برای حساب سرویس استفاده کنید .

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

درباره گوگل بیگ‌کوئری

گوگل بیگ‌کوئری (Google BigQuery) یک انبار داده سازمانی مقیاس‌پذیر و بدون سرور است که با استفاده از قدرت پردازش زیرساخت گوگل، امکان پرس‌وجوهای SQL فوق‌العاده سریع را فراهم می‌کند. از آنجا که هیچ زیرساختی برای مدیریت وجود ندارد، می‌توانید بدون نیاز به مدیر پایگاه داده، بر تجزیه و تحلیل داده‌ها تمرکز کنید تا با استفاده از SQL آشنا، بینش‌های معناداری پیدا کنید.

برای آشنایی عملی، یکی از راهنماهای سریع Google BigQuery را امتحان کنید.

اقدامات

درج

مجموعه‌ای از رکوردها را به عنوان یک مجموعه داده مستقیماً در 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. رشته هیچ کدام. بله.
ردیف‌ها ردیف‌هایی که باید در جدول درج شوند. آرایه هیچ کدام. بله.
میز نام جدولی که قرار است داده‌ها در آن دریافت شوند. رشته هیچ کدام. بله.

پاسخ

هیچ کدام.

ردیف‌های لیست

ردیف‌های جدول مشخص شده توسط شناسه جدول و شناسه مجموعه داده را لیست می‌کند.

نحو

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

پارامترهای درخواست

پارامتر توضیحات نوع پیش‌فرض مورد نیاز
مجموعه داده‌ها شناسه‌ی مجموعه داده‌ای که سطرها از آن فهرست می‌شوند. رشته هیچ کدام. بله.
حد حداکثر تعداد ردیف‌ها برای فهرست کردن عدد صحیح هیچ کدام. خیر.
شروع فهرست اندیس ردیفی که لیست از آن شروع می‌شود. عدد صحیح هیچ کدام. خیر.
میز شناسه جدولی که سطرهای آن لیست می‌شوند. رشته هیچ کدام. بله.

پاسخ

یک آرایه 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 مقدار پیکربندی مخصوص افزونه ای که اضافه می کنید. به ویژگی های این بسته برنامه افزودنی مراجعه کنید هیچ یک آره

ویژگی‌های این بسته الحاقی

مقادیر مربوط به ویژگی‌های پیکربندی زیر را که مختص این افزونه هستند، مشخص کنید.

ملک توضیحات پیش‌فرض مورد نیاز
شناسه پروژه شناسه پروژه گوگل کلود که داده‌ها در آن ذخیره می‌شوند. هیچ کدام. بله.
اعتبارنامه‌ها وقتی در کنسول Apigee Edge وارد می‌شود، این محتویات فایل کلید حساب سرویس شماست. وقتی با استفاده از API مدیریت ارسال می‌شود، یک مقدار کدگذاری شده با پایه 64 است که از فایل کلید حساب سرویس تولید می‌شود. هیچ کدام. بله.