إضافة Google BigQuery

أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
info

الإصدار 2.0.0

إدراج صفوف في جدول BigQuery إدراج الصفوف من الجدول

المتطلبات الأساسية

يوفّر هذا المحتوى مرجعًا لضبط هذه الإضافة واستخدامها. قبل استخدام الإضافة من خادم وكيل لواجهة برمجة التطبيقات باستخدام سياسة ExtensionCallout، عليك إجراء ما يلي:

  1. تأكَّد من تفعيل BigQuery API لحسابك.

  2. تأكَّد من أنّك أنشأت dataset وجدولاً (مع مخطّط) في BigQuery قبل محاولة إدراج الصفوف.

  3. استخدِم وحدة تحكّم Google Cloud Platform لإنشاء مفتاح لحساب الخدمة.

  4. استخدِم محتوى ملف JSON الناتج عن المفتاح عند إضافة الإضافة وضبطها باستخدام مرجع الإعدادات.

لمحة عن Google BigQuery

Google BigQuery هو مستودع بيانات للمؤسسات يعمل بدون خادم ويمكن توسيع نطاقه، ويتيح إجراء طلبات بحث فائقة السرعة باستخدام لغة الاستعلامات البنيوية (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"}
  ]
}
المَعلمة الوصف النوع تلقائي مطلوب
صفوف صفيف الصفوف التي تمّ إرجاعها من الطلب مصفوفة بلا عُري نعم.

مرجع الإعدادات

استخدِم ما يلي عند ضبط هذه الإضافة ونشرها لاستخدامها في الخوادم الوكيلة لواجهات برمجة التطبيقات. لمعرفة خطوات ضبط إضافة باستخدام وحدة تحكّم Apigee، اطّلِع على إضافة إضافة وضبطها.

سمات الإضافات الشائعة

السمات التالية متاحة لكل إضافة.

الموقع الوصف تلقائي عنصر مطلوب
name الاسم الذي تُعطِه هذه الإضافة من الإضافات. لا ينطبق متوافق
packageName اسم حزمة الإضافة كما هو مُوضَّح من Apigee Edge. لا ينطبق متوافق
version رقم إصدار حزمة الإضافة التي تجري عملية إعداد الإضافة منها. لا ينطبق متوافق
configuration قيمة الإعداد المتعلقة بالإضافة التي تدرجها الاطّلاع على خصائص حزمة الإضافات هذه لا ينطبق متوافق

سمات حزمة الإضافة هذه

حدِّد قيمًا لسمات الإعدادات التالية الخاصة بهذه الإضافة.

الموقع الوصف تلقائي مطلوب
projectId رقم تعريف مشروع Google Cloud Platform الذي تتوفّر فيه البيانات بلا عُري نعم.
بيانات الاعتماد عند إدخالها في وحدة تحكّم Apigee Edge، هذه هي محتويات ملف مفتاح حساب الخدمة. عند إرسالها من خلال Management API، تكون قيمة مُشفَّرة بترميز base64 تم إنشاؤها من ملف مفتاح حساب الخدمة. بلا عُري نعم.