Google BigQuery Uzantısı

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri.
bilgi

Sürüm 1.0.0

BigQuery tablosuna satır ekleyin. Tablodaki satırları listeleyin.

Ön koşullar

Bu içerik, bu uzantının yapılandırılması ve kullanılması için referans sağlamaktadır. ExtensionCall politikası ile uzantıyı bir API proxy'sinden kullanmadan önce şunları yapmanız gerekir:

  1. Hesabınız için BigQuery API'yi etkinleştirdiğinizden emin olun.

  2. Satır eklemeyi denemeden önce bir BigQuery veri kümesi ve tablo (şema ile) oluşturduğunuzdan emin olun.

  3. GCP Console'u kullanarak hizmet hesabı için bir anahtar oluşturun.

  4. Yapılandırma referansını kullanarak uzantıyı eklerken ve yapılandırırken sonuçta ortaya çıkan anahtar JSON dosyasının içeriğini kullanın.

Google BigQuery hakkında

Google BigQuery, Google altyapısının işleme gücünü kullanarak SQL sorgularının olağanüstü bir hızla çalıştırılmasını sağlayan sunucusuz ve ölçeklenebilir bir kurumsal veri ambarıdır. Yönetilecek bir altyapı olmadığından, veritabanı yöneticisine ihtiyaç duymadan, aşina olduğunuz SQL'den yararlanarak anlamlı analizler bulmak için veri analizine odaklanabilirsiniz.

Uygulamalı giriş için Google BigQuery hızlı başlangıç kılavuzlarından birini deneyin.

İşlemler

insert

Kayıt gruplarını, eklenecek satırlar ve veri kümesi/tablo kimliğiyle doğrudan BigQuery'ye veri kümesi olarak ekleyin.

Söz dizimi

<Action>insert</Action>
<Input><![CDATA[{
  "dataset" : dataset-to-insert,
  "table" : table-to-receive-data,
  "rows" : array-of-rows-to-insert
}]]></Input>

Örnek

<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>

İstek parametreleri

Parametre Açıklama Tür Varsayılan Zorunlu
veri kümesi BigQuery'ye eklenecek veri kümesinin kimliği. Dize Yok. Evet.
satırlar Tabloya eklenecek satırlar. Dizi Yok. Evet.
masa Verileri alacak tablonun adı. Dize Yok. Evet.

Yanıt

Yok.

listRows

Tablo kimliği ve veri kümesi kimliğiyle belirtilen tablodaki satırları listeler.

Söz dizimi

<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>

Örnek

<Action>listRows</Action>
<Input><![CDATA[{
  "dataset" : "TestData",
  "limit" : 2,
  "startIndex" : 1,
  "table" : "TestTable"
}]]></Input>

İstek parametreleri

Parametre Açıklama Tür Varsayılan Zorunlu
veri kümesi Satırların listeleneceği veri kümesinin kimliği. Dize Yok. Evet.
sınır Listelenecek maksimum satır sayısı. Tamsayı Yok. Sıra
startIndex Listenin başlatılacağı satır dizini. Tamsayı Yok. Sıra
masa Satırların listeleneceği tablonun kimliği. Dize Yok. Evet.

Yanıt

rows dizisi.

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
Parametre Açıklama Tür Varsayılan Zorunlu
satırlar İstekten döndürülen satır dizisi. Dizi Yok. Evet.

Yapılandırma Referansı

Bu uzantıyı API proxy'lerinde kullanmak üzere yapılandırıp dağıtırken aşağıdakileri kullanın. Apigee konsolunu kullanarak uzantı yapılandırma adımları için Uzantı ekleme ve yapılandırma'ya bakın.

Sık kullanılan uzantı özellikleri

Aşağıdaki özellikler her uzantı için mevcuttur.

Mülk Açıklama Varsayılan Zorunlu
name Uzantının bu yapılandırmasını verdiğiniz ad. Yok Evet
packageName Apigee Edge'in sağladığı uzantı paketinin adı. Yok Evet
version Uzantıyı yapılandırdığınız uzantı paketinin sürüm numarası. Yok Evet
configuration Eklediğiniz uzantıya özgü yapılandırma değeri. Bu uzantı paketinin özellikleri başlıklı makaleyi inceleyin Yok Evet

Bu uzantı paketinin özellikleri

Bu uzantıya özel aşağıdaki yapılandırma özelliklerinin değerlerini belirtin.

Özellik Açıklama Varsayılan Zorunlu
proje kimliği Verilerin bulunduğu GCP projesinin kimliği. Yok. Evet.
giriş bilgileri Apigee Edge konsoluna girildiğinde hizmet hesabı anahtar dosyanızın içeriği bu şekildedir. Management API aracılığıyla gönderildiğinde, hizmet hesabı anahtar dosyasından oluşturulan base64 kodlu bir değerdir. Yok. Evet.