إضافة Google BigQuery

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

الإصدار 2.0.2

يمكنك إدراج صفوف في جدول BigQuery. يمكنك عرض صفوف من الجدول.

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

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

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

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

  3. استخدام Google Cloud Console لإنشاء مفتاح لحساب الخدمة.

  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 الذي يحتوي على البيانات بلا عُري نعم.
بيانات الاعتماد عند إدخالها في وحدة تحكّم Apigee Edge، تكون هذه محتويات ملف مفتاح حساب الخدمة . عند إرسالها باستخدام Management API، تكون قيمة بترميز base64 تم إنشاؤها من ملف مفتاح حساب الخدمة. بلا عُري نعم.