أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
الإصدار 2.0.1
إدراج صفوف في جدول BigQuery إدراج صفوف من الجدول
المتطلبات الأساسية
يوفّر هذا المحتوى مرجعًا لإعداد هذه الإضافة واستخدامها. قبل استخدام الإضافة من خادم وكيل لواجهة برمجة التطبيقات باستخدام سياسة ExtensionCallout، عليك إجراء ما يلي:
تأكَّد من تفعيل BigQuery API لحسابك.
تأكَّد من أنّك أنشأت مجموعة بيانات وجدولاً في BigQuery (مع مخطط) قبل محاولة إدراج الصفوف.
استخدِم وحدة تحكّم Google Cloud Platform لإنشاء مفتاح لحساب الخدمة.
استخدِم محتوى ملف مفتاح 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"}
]
}
المَعلمة | الوصف | النوع | تلقائي | مطلوب |
---|---|---|---|---|
صفوف | مصفوفة الصفوف التي تم عرضها من الطلب. | مصفوفة | بلا عُري | نعم. |
مرجع الإعدادات
استخدِم ما يلي عند ضبط هذه الإضافة ونشرها لاستخدامها في خوادم API الوكيلة. للاطّلاع على خطوات إعداد إضافة باستخدام وحدة تحكّم Apigee، راجِع إضافة إضافة وإعدادها.
خصائص الإضافة الشائعة
السمات التالية متاحة لكل إضافة.
الموقع | الوصف | تلقائي | عنصر مطلوب |
---|---|---|---|
name |
الاسم الذي تُعطِه هذه الإضافة من الإضافات. | لا ينطبق | متوافق |
packageName |
اسم حزمة الإضافة كما هو مُوضَّح من Apigee Edge. | لا ينطبق | متوافق |
version |
رقم إصدار حزمة الإضافة التي تجري عملية إعداد الإضافة منها. | لا ينطبق | متوافق |
configuration |
قيمة الإعداد المتعلقة بالإضافة التي تدرجها الاطّلاع على خصائص حزمة الإضافات هذه | لا ينطبق | متوافق |
سمات حزمة الإضافة هذه
حدِّد قيمًا لخصائص الإعداد التالية الخاصة بهذه الإضافة.
الموقع | الوصف | تلقائي | مطلوب |
---|---|---|---|
projectId | معرّف مشروع Google Cloud Platform الذي تتوفّر فيه البيانات | بلا عُري | نعم. |
بيانات الاعتماد | عند إدخال هذا الرمز في وحدة تحكّم Apigee Edge، سيكون هذا هو محتوى ملف مفتاح حساب الخدمة. عند إرسالها من خلال واجهة برمجة التطبيقات الإدارية، تكون قيمة مرمّزة بترميز base64 تم إنشاؤها من ملف مفتاح حساب الخدمة. | بلا عُري | نعم. |