Analytics'teki verileri dışa aktarma

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin.
bilgi

Atanan hizmet aracıları için izinleri ayarlama

Atanan hizmet aracıları için izinleri ayarlamak amacıyla yukarıda açıklanan değişikliklere hazırlanmak amacıyla aşağıdaki adımları uygulayın.

  1. Aşağıdaki komutu girerek Google Cloud hizmet aracınızın adını bulun:
    curl -X GET \
      "https://api.enterprise.apigee.com/v1/organizations/ORG" \
      -u email:password \
      | jq -r '.properties.property[] | select(.name=="serviceAgent.analytics") | .value'

    ORG kuruluşunuz sizin. Bu komut, hizmet aracısının aşağıda gösterildiği gibi adını ve değerini döndürür:

    "property" : [
      {
       "name" : "serviceAgent.analytics",
       "value" : "service-9q1ibk@gcp-sa-apigee-uap.iam.gserviceaccount.com"
       },
  2. Google Cloud konsolunda IAM kontrol panelini açın.
  3. Google Cloud projenizi seçin.
  4. IAM bölmesinin üst tarafındaki Ekle'yi tıklayın.
  5. Yeni ana hesaplar alanına, 1. adımda döndürülen value hizmet aracısını girin. Örneğin, 1. adımda gösterilen value, service-9q1ibk@gcp-sa-apigee-uap.iam.gserviceaccount.com'dir.
  6. +Başka Bir Rol Ekle düğmesini tıklayın ve aşağıdaki rolleri ekleyin:
    • BigQuery Kullanıcısı
    • Storage Yöneticisi
  7. Kaydet'i tıklayın.

Apigee Analytics verileri

Apigee Analytics, API'leriniz genelinde gelen geniş bir veri yelpazesini toplayıp analiz eder. Ayrıca etkileşimli kontrol panelleri, özel raporlar ve API proxy performansındaki eğilimleri belirleyen diğer araçlar dahil olmak üzere görselleştirme araçları sunar. Artık analiz verilerini Apigee Analytics'ten Google Cloud Storage veya Google BigQuery gibi kendi veri deponuza aktararak bu zengin içerikten yararlanabilirsiniz. Ardından, kendi veri analizlerinizi gerçekleştirmek için Google BigQuery ve TensorFlow'un sunduğu güçlü sorgu ve makine öğrenimi özelliklerinden yararlanabilirsiniz. Ayrıca kullanıcılarınız, API'leriniz ve uygulamalarınız hakkında yeni analizler elde etmek için dışa aktarılan analiz verilerini web günlükleri gibi diğer verilerle birleştirebilirsiniz.

Veri biçimini dışa aktarma

Analiz verilerini aşağıdaki biçimlerden birinde dışa aktarın:

  • Virgülle ayrılmış değerler (CSV)

    Varsayılan sınırlayıcı virgül (,) karakteridir. Ayırıcı karakterler arasında virgül (,), dikey çizgi (|) ve sekme (\t) bulunur. Değeri, csvDelimiter özelliğini kullanarak İstek mülk referansını dışa aktarma bölümünde açıklandığı şekilde yapılandırın .

  • JSON (yeni satırla ayrılmış)

    Yeni satır karakterinin sınırlayıcı olarak kullanılmasına izin verir.

Dışa aktarılan veriler, Edge'de yerleşik olarak bulunan tüm analiz metriklerini ve boyutlarını ve eklediğiniz tüm özel analiz verilerini içerir. Dışa aktarılan verilerin açıklaması için Analytics metrikleri, boyutları ve filtreleri referansı bölümünü inceleyin.

Analiz verilerini aşağıdaki veri depolarına aktarabilirsiniz:

Dışa aktarma sürecine genel bakış

Aşağıdaki adımlarda, analiz verilerinizi dışa aktarmak için kullanılan süreç özetlenmektedir:

  1. Verileri dışa aktarmak için veri deponuzu (Cloud Storage veya BigQuery) yapılandırın. Veri deponuzun doğru yapılandırıldığından ve veri deposuna veri yazmak için kullanılan hizmet hesabının doğru izinlere sahip olduğundan emin olmanız gerekir.

  2. Veri deposuna erişmek için kullanılan kimlik bilgileri dahil olmak üzere, verilerinizi dışa aktardığınız veri deposunun (Cloud Storage veya BigQuery) özelliklerini tanımlayan bir veri deposu oluşturun.

    Bir veri deposu oluşturduğunuzda, güvenli bir şekilde depolamak için veri deposu kimlik bilgilerini Edge Kimlik Bilgisi Apps Kasası'na yüklersiniz. Ardından veri dışa aktarma mekanizması bu kimlik bilgilerini kullanarak veri deponuza veri yazar.

  3. Veri dışa aktarma işlemini başlatmak için Veri Dışa Aktarma API'sını kullanın. Veri dışa aktarma işlemi arka planda eşzamansız olarak çalışır.

  4. Dışa aktarma işleminin ne zaman tamamlanacağını belirlemek için veri dışa aktarma API'sini kullanın.

  5. Dışa aktarma işlemi tamamlandığında veri deponuzda dışa aktarılan verilere erişin.

Aşağıdaki bölümlerde bu adımlar daha ayrıntılı olarak açıklanmaktadır.

Veri deponuzu yapılandırın

Analiz verilerini dışa aktarma mekanizması, verileri Cloud Storage veya BigQuery'ye yazar. Bu yazma işleminin gerçekleşmesi için:

  • Google Cloud Platform hizmet hesabı oluşturun.
  • Cloud Storage veya BigQuery'ye erişebilmesi için hizmet hesabının rolünü ayarlayın.

Cloud Storage veya BigQuery için hizmet hesabı oluşturma

Hizmet hesabı, bireysel bir kullanıcıya değil, uygulamanıza ait olan bir Google hesabı türüdür. Uygulamanız daha sonra bir hizmete erişmek için hizmet hesabını kullanır.

Hizmet hesaplarında, JSON dizesiyle temsil edilen bir hizmet hesabı anahtarı bulunur. Veri deponuzla bağlantıyı tanımlayan Edge veri deposunu oluşturduğunuzda bu anahtarı iletirsiniz. Ardından veri dışa aktarma mekanizması, veri deponuza erişmek için bu anahtarı kullanır.

Anahtarla ilişkilendirilen hizmet hesabı bir Google Cloud Platform proje sahibi olmalı ve Google Cloud Storage paketine yazma erişimine sahip olmalıdır. Bir hizmet anahtarı oluşturmak ve gerekli yükü indirmek için Google Cloud Platform belgelerindeki Hizmet Hesabı Anahtarları Oluşturma ve Yönetme bölümünü inceleyin.

Örneğin, anahtarınızı ilk indirdiğinizde bir JSON nesnesi olarak biçimlendirilir:

{ 
  "type": "service_account", 
  "project_id": "myProject", 
  "private_key_id": "12312312", 
  "private_key": "-----BEGIN PRIVATE KEY-----\n...", 
  "client_email": "client_email@developer.gserviceaccount.com", 
  "client_id": "879876769876", 
  "auth_uri": "https://accounts.google.com/organizations/oauth2/auth", 
  "token_uri": "https://oauth2.googleapis.com/token", 
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2", 
  "client_x509_cert_url": "https://www.googleapis.com" 
}

Google Cloud Storage'ı yapılandırma

Verileri Google Cloud Storage'a aktarabilmeniz için:

  • Google Cloud Platform projenizde BigQuery ve Cloud Resource Manager API'lerinin etkinleştirildiğinden emin olun. Talimatlar için API'leri etkinleştirme sayfasına bakın. Apigee, Cloud Storage'a aktarma sırasında BigQuery Export özelliklerinden yararlanmak için BigQuery API'yi, her dışa aktarma işleminden önce izni kontrol etmek için Cloud Resource Manager API'yi kullanır.
  • Hizmet hesabının aşağıdaki rollere atandığından emin olun:

    • BigQuery İş Kullanıcısı
    • Storage Nesne Oluşturucu
    • Depolama Alanı Yöneticisi (yalnızca Veri deposu yapılandırmasını test etme bölümünde açıklandığı gibi, veri deposunu test etmek için gereklidir). Bu rol çok genişse bunun yerine storage.buckets.get iznini mevcut bir role ekleyebilirsiniz.)

    Alternatif olarak, mevcut bir rolü değiştirmek veya özel bir rol oluşturmak isterseniz role aşağıdaki izinleri ekleyin:

Google BigQuery'yi yapılandırın

Verileri Google BigQuery'ye aktarmadan önce:

  • Google Cloud Platform projenizde BigQuery ve Cloud Resource Manager API'lerinin etkinleştirildiğinden emin olun. Talimatlar için API'leri etkinleştirme sayfasına bakın. Apigee, her dışa aktarma işleminden önce izni kontrol etmek için Cloud Resource Manager API'yi kullanır.
  • Google Cloud Platform projenizde BigQuery API'nin etkinleştirildiğinden emin olun. Talimatlar için API'leri Etkinleştirme ve Devre Dışı Bırakma sayfasına bakın.
  • Hizmet hesabının aşağıdaki rollere atandığından emin olun:

    • BigQuery İş Kullanıcısı
    • BigQuery Veri Düzenleyicisi

    Mevcut bir rolü değiştirmek veya özel bir rol oluşturmak istiyorsanız role aşağıdaki izinleri ekleyin:

    • bigquery.datasets.create
    • bigquery.datasets.get
    • bigquery.jobs.create
    • bigquery.tables.create
    • bigquery.tables.get
    • bigquery.tables.updateData

Veri deposu oluşturma

Veri deposu, veri havuzuna erişmek için kullanılan kimlik bilgileri de dahil olmak üzere dışa aktarılan veri deponuzla (Cloud Storage, BigQuery) bağlantıyı tanımlar.

Edge Kimlik Bilgileri Apps Kasası hakkında

Edge, dışa aktarma veri deponuza erişmek için kullanılan kimlik bilgilerini güvenli bir şekilde depolamak için Kimlik Bilgisi Apps Kasası'nı kullanır. Bir hizmetin Edge Kimlik Bilgileri Apps Kasası'ndaki kimlik bilgilerine erişebilmesi için bir kimlik bilgisi tüketicisi tanımlamanız gerekir.

Aşağıda açıklandığı gibi Edge kullanıcı arayüzünü kullanarak bir veri deposu oluştururken Edge, kimlik bilgilerine erişmek için kullanılan tüketiciyi otomatik olarak oluşturur.

Veri deposu yapılandırmasını test etme

Veri deposunu oluşturduğunuzda Edge, kimlik bilgilerinizin ve veri deposu yapılandırmanızın geçerli olduğunu test etmez veya doğrulamaz. Diğer bir deyişle, veri deposunu oluşturabilir ve ilk veri dışa aktarma işleminize kadar herhangi bir hata tespit etmeyebilirsiniz.

Alternatif olarak, veri deposu yapılandırmasını oluşturmadan önce test edin. Büyük bir veri dışa aktarma işleminin yürütülmesi uzun sürebileceğinden testler yararlıdır. Büyük miktarda veri indirmeye başlamadan önce kimlik bilgilerinizi ve veri deposu yapılandırmanızı test ederek ayarlarınızla ilgili sorunları hızlı bir şekilde düzeltebilirsiniz.

Test başarılı olursa veri deposunu oluşturun. Test başarısız olursa hataları düzeltip yapılandırmayı yeniden test edin. Veri deposunu yalnızca testler başarılı olduktan sonra oluşturursunuz.

Test özelliğini etkinleştirmek için:

Veri deposu oluşturma

Kullanıcı arayüzünde bir veri deposu oluşturmak için:

  1. Kuruluş yöneticisi olarak https://apigee.com/edge adresinde oturum açın ve kuruluşunuzu seçin.

    NOT: Veri deposu oluşturabilmek için bir Edge kuruluş yöneticisi olmanız gerekir.

  2. Sol gezinme çubuğundan Yönetici > Analytics Veri Depoları'nı seçin. Analytics Veri Depoları sayfası görüntülenir.

  3. + Veri Deposu Ekle düğmesini seçin. Veri deposu türünü seçmeniz istenir:

  4. Dışa aktarma verileri hedefi türü seçin:

    • Google Cloud Storage
    • Google BigQuery

    Yapılandırma sayfası görüntülenir:

  5. Veri deposu adını girin.

  6. Veri havuzuna erişmek için kullanılan bir kimlik bilgisi seçin. Kullanılabilir kimlik bilgilerini içeren bir açılır liste görünür.

    Kimlik bilgileri, veri deposu türüne özgüdür. Daha fazla bilgi için Cloud Storage veya BigQuery için hizmet hesabı oluşturma başlıklı makaleyi inceleyin.

    • Kimlik bilgilerini zaten yüklediyseniz açılır listeden kimlik bilgilerini seçin. Veri deposu türüne uygun kimlik bilgilerini seçtiğinizden emin olun.

    • Veri deposuna yeni kimlik bilgileri ekliyorsanız Yeni ekle'yi seçin. İletişim kutusuna şu ifadeyi girin:

      1. Kimlik bilgisi adı.
      2. Kimlik bilgisi içeriği, Cloud Storage veya BigQuery için hizmet hesabı oluşturma bölümünde tanımlandığı üzere veri deponuza özgü JSON hizmet hesabı anahtarıdır.
      3. Oluştur'u seçin.
  7. Veri deposu türüne özgü özellikleri girin:

    • Google Cloud Storage için:
      Özellik Açıklama Zorunlu mu?
      Proje kimliği Google Cloud Platform proje kimliği.

      Google Cloud Platform projesi oluşturmak için Google Cloud Platform belgelerindeki Proje Oluşturma ve Yönetme bölümüne bakın.

      Evet
      Paket Adı Cloud Storage'da analiz verilerini dışa aktarmak istediğiniz paketin adı. Veri dışa aktarma işlemi yapabilmeniz için paketin mevcut olması gerekir.

      Cloud Storage paketi oluşturmak için Google Cloud Platform belgelerinde Depolama Paketleri Oluşturma bölümüne bakın.

      Evet
      Path Analiz verilerinin Cloud Storage paketinde depolanacağı dizin. Evet
    • BigQuery için:
      Özellik Açıklama Zorunlu mu?
      Proje kimliği Google Cloud Platform proje kimliği.

      Google Cloud Platform projesi oluşturmak için Google Cloud Platform belgelerindeki Proje Oluşturma ve Yönetme bölümüne bakın.

      Evet
      Veri Kümesi Adı Analiz verilerini dışa aktarmak istediğiniz BigQuery veri kümesinin adı. Veri dışa aktarma isteğinde bulunmadan önce veri kümesinin oluşturulduğundan emin olun.

      BigQuery veri kümesi oluşturmak için Google Cloud Platform dokümanlarındaki Veri Kümeleri Oluşturma ve Kullanma bölümüne bakın.

      Evet
      Tablo Öneki BigQuery veri kümesindeki analiz verileri için oluşturulan tabloların adlarının ön eki. Evet
  8. Kimlik bilgilerinin veri havuzuna erişmek üzere kullanılabileceğinden emin olmak için Bağlantıyı test et'i seçin.

    Test başarılı olursa veri deponuzu kaydedin.

    Test başarısız olursa sorunları düzeltip testi yeniden deneyin. İpucunda ek bilgiler görüntülemek için farenizi kullanıcı arayüzündeki hata mesajının üzerine getirin.

  9. Bağlantı testi başarılı olduktan sonra veri deposunu kaydedin.

Veri deposunu değiştirme

Bir veri deposunu değiştirmek için:

  1. Kuruluş yöneticisi olarak https://apigee.com/edge adresinde oturum açın ve kuruluşunuzu seçin.

  2. Sol gezinme çubuğundan Yönetici > Analytics Veri Depoları'nı seçin. Analytics Veri Depoları sayfası görüntülenir.

  3. Değişiklik yapmak için fare imlecini raporun Değiştirildi sütununun üzerine getirin. Bir düzenle ve sil simgesi görünür.

  4. Veri deposunu düzenleyin veya silin.

  5. Veri deposunu düzenlediyseniz, kimlik bilgilerinin veri deposuna erişmek üzere kullanılabileceğinden emin olmak için Bağlantıyı test et'i seçin.

    Test başarılı olursa örnek verileri veri deponuzda görüntüleyebilirsiniz.

    Test başarısız olursa sorunları düzeltip testi yeniden deneyin.

  6. Bağlantı testi başarılı olduktan sonra veri deposunu güncelleyin.

Analiz verilerini dışa aktarma

Analiz verilerini dışa aktarmak için /analytics/exports API'ye bir POST isteği gönderin. İstek gövdesine aşağıdaki bilgileri iletin:

  • Dışa aktarma isteğinin adı ve açıklaması
  • Dışa aktarılan verilerin tarih aralığı (değer yalnızca bir günü kapsayabilir)
  • Dışa aktarılan verilerin biçimi
  • Veri deposu adı
  • Kuruluşta para kazanma özelliğinin etkin olup olmadığı

Dışa aktarma istekleriyle ilgili örnekler aşağıda verilmiştir. İstek gövdesi özelliklerinin tam açıklaması için İstek özelliği referansını dışa aktarma bölümüne bakın.

POST tarafından gönderilen yanıt şu biçimde:

{
    "self": "/organizations/myorg/environments/test/analytics/exports/a7c2f0dd-1b53-4917-9c42-a211b60ce35b",
    "created": "2017-09-28T12:39:35Z",
    "state": "enqueued"
}

Yanıttaki state özelliğinin enqueued olarak ayarlandığını unutmayın. POST isteği eşzamansız olarak çalışır. Diğer bir deyişle, istek bir yanıt döndürdükten sonra uygulama arka planda çalışmaya devam eder. state için olası değerler şunlardır: enqueued, running, completed, failed.

Veri dışa aktarma isteğinin durumunu görüntülemek için self mülkünde döndürülen URL'yi kullanın (Analytics dışa aktarma isteğinin durumunu görüntüleme bölümünde açıklandığı şekilde). İstek tamamlandığında, yanıttaki state özelliğinin değeri completed olarak ayarlanır. Ardından veri deponuzdaki analiz verilerine erişebilirsiniz.

1. Örnek: Verileri Cloud Storage'a aktarma

Aşağıdaki istek, myorg kuruluşundaki test ortamından son 24 saat içindeki ham verilerin tamamını dışa aktarır. İçerik, Cloud Storage'a JSON biçiminde aktarılır:

curl -X POST -H "Content-Type:application/json" \
"https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/analytics/exports" \
  -d \
  '{
    "name": "Export raw results to Cloud Storage",
    "description": "Export raw results to Cloud Storage for last 24 hours",
    "dateRange": {
      "start": "2018-06-08", 
      "end": "2018-06-09"
    },
    "outputFormat": "json",
    "datastoreName": "My Cloud Storage data repository"
  }' \
  -u orgAdminEmail:password

İş durumunu Analiz dışa aktarma isteğinin durumunu görüntüleme bölümünde açıklandığı gibi izlemek için self özelliği tarafından belirtilen URI'yi kullanın.

2. Örnek: Verileri BigQuery'ye aktarma

Aşağıdaki istek, virgülle ayrılmış bir CSV dosyasını BigQuery'ye aktarır:

curl -X POST -H "Content-Type:application/json"  \
  "https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/analytics/exports" \
  -d \
  '{
    "name": "Export query results to BigQuery",
    "description": "One-time export to BigQuery",
    "dateRange": {
      "start": "2018-06-08", 
      "end": "2018-06-09"
    },
    "outputFormat": "csv",
    "csvDelimiter": ",", 
    "datastoreName": "My BigQuery data repository"
  }' \
  -u orgAdminEmail:password

Not: Dışa aktarılan CSV dosyası, aşağıdaki ön ekle başlayan bir BigQuery tablosu oluşturur:

<PREFIX>_<EXPORT_DATE>_api_<UUID>_from_<FROM_DATE>_to_<TO_DATE>

İş durumunu Analytics dışa aktarma isteğinin durumunu görüntüleme bölümünde açıklandığı gibi izlemek için self özelliği tarafından belirtilen URI'yi kullanın.

3. Örnek: Para kazanma verilerini dışa aktarma

Kuruluşunuzdaki bir ortamda para kazanma özelliği etkinleştirilmişse iki tür veri dışa aktarma işlemi gerçekleştirebilirsiniz:

  • Önceki iki örnekte gösterildiği gibi standart veri dışa aktarma işlemi.
  • Para kazanmayla ilgili verileri dışa aktarmak için para kazanma verilerini dışa aktarın.

Para kazanma verilerini dışa aktarmak için istek yükünde "dataset":"mint" değerini belirtin. Bu seçeneğin ayarlanması için kuruluş ve ortamın para kazanma özelliğini desteklemesi gerekir. Aksi takdirde dataset özelliğini yükten çıkarın:

  '{
    "name": "Export raw results to Cloud Storage",
    "description": "Export raw results to Cloud Storage for last 24 hours",
    "dateRange": {
      "start": "2018-06-08", 
      "end": "2018-06-09"
    },
    "outputFormat": "json",
    "datastoreName": "My Cloud Storage data repository",
    "dataset":"mint"
  }'

Export API kotaları hakkında

Edge, pahalı veri dışa aktarma API'si çağrılarının aşırı kullanılmasını önlemek için /analytics/exports API'ye yapılan çağrılara bir kota uygular:

  • Para kazanma özelliğinin etkinleştirilmediği kuruluşlar ve ortamlar için kota:

    • Kuruluş/ortam başına aylık 70 çağrı.

    Örneğin, kuruluşunuzda prod ve test adlı iki ortam varsa her ortam için ayda 70 API çağrısı yapabilirsiniz.

  • Para kazanma özelliğinin etkin olduğu kuruluşlar ve ortamlar için kota:

    • Her kuruluş ve ortam için standart veriler için aylık 70 çağrı.
    • Her kuruluş ve ortam için para kazanma verileri için ayda 70 çağrı.

    Örneğin, prod kuruluşunuzda para kazanmayı etkinleştirirseniz standart veriler için 70 API çağrısı ve para kazanma verileri için 70 ek API çağrısı yapabilirsiniz.

Çağrı kotasını aşarsanız API, HTTP 429 yanıtı döndürür.

Tüm Analytics dışa aktarma isteklerinin durumunu görüntüleme

Tüm analiz dışa aktarma isteklerinin durumunu görüntülemek için /analytics/exports adresine GET isteği gönderin.

Örneğin, aşağıdaki istek myorg kuruluşundaki test ortamı için tüm Analytics dışa aktarma isteklerinin durumunu döndürür:

curl -X GET \
  "https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/analytics/exports" \
  -u email:password

Aşağıda, biri sıraya alınmış (oluşturulmuş ve sıraya alınmış) diğeri tamamlanmış olmak üzere iki dışa aktarma isteğini listeleyen yanıtın bir örneği verilmiştir:

[
  {
    "self":
"/v1/organizations/myorg/environments/test/analytics/exports/e8b8db22-fe03-4364-aaf2-6d4f110444ba",
    "name": "Export results To Cloud Storage",
    "description": "One-time export to Google Cloud Storage",
    "userId": "my@email.com",
    "datastoreName": "My Cloud Storage data store",
    "executionTime": "36 seconds",
    "created": "2018-09-28T12:39:35Z",
    "updated": "2018-09-28T12:39:42Z",
    "state": "enqueued"
  },
  {
    "self":
"/v1/organizations/myorg/environments/test/analytics/exports/9870987089fe03-4364-aaf2-6d4f110444ba"
    "name": "Export raw results to BigQuery",
    "description": "One-time export to BigQuery",
    ... 
  }
]

Analytics dışa aktarma isteğinin durumunu görüntüleme

Belirli bir Analytics dışa aktarma isteğinin durumunu görüntülemek için /analytics/exports/{exportId} adresine bir GET isteği gönderin. Burada {exportId}, Analytics dışa aktarma isteğiyle ilişkilendirilmiş kimliktir.

Örneğin, aşağıdaki istek 4d6d94ad-a33b-4572-8dba-8677c9c4bd98 kimliğine sahip Analytics dışa aktarma isteğinin durumunu döndürür.

curl -X GET \
"https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/analytics/exports/4d6d94ad-a33b-4572-8dba-8677c9c4bd98" \
-u email:password

Aşağıda yanıtla ilgili bir örnek yer almaktadır:

{
  "self":
"/v1/organizations/myorg/environments/test/analytics/exports/4d6d94ad-a33b-4572-8dba-8677c9c4bd98",
  "name": "Export results To Cloud Storage",
  "description": "One-time export to Google Cloud Storage",
  "userId": "my@email.com",
  "datastoreName": "My Cloud Storage data store",
  "executionTime": "36 seconds",
  "created": "2018-09-28T12:39:35Z",
  "updated": "2018-09-28T12:39:42Z",
  "state": "enqueued"
}

Analizleri dışa aktarma işlemi hiçbir analiz verisi döndürmediyse executionTime, "0 saniye" olarak ayarlanır.

Dışa aktarma isteği özellik referansı

Aşağıdaki tabloda, analiz verilerini dışa aktarırken istek gövdesinde JSON biçiminde iletebileceğiniz özellikler açıklanmaktadır.

Özellik Açıklama Zorunlu mu?
description Dışa aktarma isteğinin açıklaması. Hayır
name Dışa aktarma isteğinin adı. Evet
dateRange

Dışa aktarılacak verilerin start ve end tarihini yyyy-mm-dd biçiminde belirtin. Örneğin:

"dateRange": {
    "start": "2018-07-29",
    "end": "2018-07-30"
}

dateRange değeri yalnızca bir günü kapsayabilir. Tarih aralığı, start tarihinde 00:00:00 UTC'de başlar ve end tarihinde 00:00:00 UTC'de sona erer.

NOT: Önceki güne ait tüm verilerin yakalandığından emin olmak için dışa aktarma isteğinin başlangıç zamanını ertelemeniz gerekebilir (ör. 00:05:00 UTC).

Evet
outputFormat json veya csv olarak belirtin. Evet
csvDelimiter

outputFormat, csv olarak ayarlanırsa CSV çıkış dosyasında kullanılan sınırlayıcı. Varsayılan olarak , (virgül) karakteri kullanılır. Ayırıcı karakterler arasında virgül (,), dikey çizgi (|) ve sekme (\t) bulunur.

Hayır
datastoreName Veri deponuzun tanımını içeren veri deposu adı. Evet

Örneğin:

{
    "name": "Export raw results to Cloud Storage",
    "description": "Export raw results to Cloud Storage for last 24 hours",
    "dateRange": {
      "start": "2018-06-08", 
      "end": "2018-06-09"
    },
    "outputFormat": "json",
    "datastoreName": "My Cloud Storage data repository"
  }