إضافة Google BigQuery

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
المعلومات

الإصدار 1.2.1

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

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

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

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

  2. تأكّد من إنشاء مجموعة بيانات وجدول في 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>

مَعلمات الطلب

المَعلمة الوصف Type تلقائي مطلوبة
مجموعة بيانات رقم تعريف مجموعة البيانات المطلوب إدراجها في 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>

مَعلمات الطلب

المَعلمة الوصف Type تلقائي مطلوبة
مجموعة بيانات معرّف مجموعة البيانات المطلوب إدراج الصفوف منها. سلسلة بلا عُري نعم.
الحدّ الأقصى المسموح به الحد الأقصى لعدد الصفوف المطلوب إدراجها. عدد صحيح بلا عُري لا.
startIndex فهرس الصف الذي يمكن بدء القائمة فيه عدد صحيح بلا عُري لا.
جدول رقم تعريف الجدول الذي سيتم إدراج الصفوف منه. سلسلة بلا عُري نعم.

الإجابة

مصفوفة rows.

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
المَعلمة الوصف Type تلقائي مطلوبة
صف مصفوفة من الصفوف التي تم إرجاعها من الطلب. مصفوفة بلا عُري نعم.

مرجع التكوين

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

خصائص الإضافات الشائعة

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

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

الخصائص لحزمة الإضافات هذه

يمكنك تحديد قيم لخصائص الإعداد التالية الخاصة بهذه الإضافة.

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