إضافة 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>

معلمات الطلب

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