Bağlı Sayfalar

Bağlı Sayfalar, petabaytlarca veriyi doğrudan Google E-Tablolar'da analiz etmenize olanak tanır. E-tablolarınızı BigQuery veri ambarına veya Looker'a bağlayabilir ve pivot tablolar, grafikler ve formüller gibi tanıdık E-Tablolar araçlarını kullanarak analiz yapabilirsiniz.

BigQuery veri kaynağını yönetme

Bu bölümde, Bağlı Sayfalar'ın nasıl kullanılacağını göstermek için BigQuery Shakespeare herkese açık veri kümesi kullanılır. Veri kümesi aşağıdaki bilgileri içerir:

Alan Tür Açıklama
kelime STRING Bir derlemden çıkarılan tek bir benzersiz kelime (boşluk sınırlayıcıdır).
word_count INTEGER Bu kelimenin bu derlemde görünme sayısı.
korpus STRING Bu kelimenin ayıklandığı eser.
corpus_date INTEGER Bu derlemenin yayınlandığı yıl.

Uygulamanız herhangi bir BigQuery bağlı sayfalar verisi istiyorsa normal bir Google E-Tablolar API isteği için gereken diğer kapsamların yanı sıra bigquery.readonly kapsamı veren bir OAuth 2.0 jetonu sağlamalıdır. Daha fazla bilgi için Google Sheets API kapsamlarını seçme başlıklı makaleyi inceleyin.

Veri kaynağı, verilerin bulunduğu harici bir konumu belirtir. Veri kaynağı daha sonra e-tabloya bağlanır.

BigQuery veri kaynağı ekleme

Veri kaynağı eklemek için spreadsheets.batchUpdate yöntemini kullanarak bir AddDataSourceRequest sağlayın. İstek gövdesinde, dataSource alanının türü DataSource nesne olarak belirtilmelidir.

"addDataSource":{
   "dataSource":{
      "spec":{
         "bigQuery":{
            "projectId":"PROJECT_ID",
            "tableSpec":{
               "tableProjectId":"bigquery-public-data",
               "datasetId":"samples",
               "tableId":"shakespeare"
            }
         }
      }
   }
}

PROJECT_ID kısmını geçerli bir Google Cloud proje kimliğiyle değiştirin.

Bir veri kaynağı oluşturulduktan sonra, 500 satıra kadar önizleme sağlamak için ilişkili bir DATA_SOURCE sayfası oluşturulur. Önizleme hemen kullanılamaz. BigQuery verilerini içe aktarmak için yürütme işlemi asenkron olarak tetiklenir.

AddDataSourceResponse aşağıdaki alanları içerir:

  • dataSource: Oluşturulan DataSource nesnesi. dataSourceId, e-tablo kapsamlı benzersiz bir kimliktir. Veri kaynağındaki her DataSource nesnesini oluşturmak için doldurulur ve referans verilir.

  • dataExecutionStatus: BigQuery verilerini önizleme sayfasına aktaran bir yürütmenin durumu. Daha fazla bilgi için Veri yürütme durumu bölümüne bakın.

BigQuery veri kaynağını güncelleme veya silme

spreadsheets.batchUpdate yöntemini kullanın ve buna göre bir UpdateDataSourceRequest veya DeleteDataSourceRequest isteği gönderin.

BigQuery veri kaynağı nesnelerini yönetme

Bir veri kaynağı e-tabloya eklendikten sonra, bu veri kaynağından bir veri kaynağı nesnesi oluşturulabilir. Veri kaynağı nesnesi, veri analizinizi desteklemek için Bağlı Sayfalar ile entegre edilmiş pivot tablolar, grafikler ve formüller gibi normal bir E-Tablolar aracıdır.

Dört tür nesne vardır:

  • DataSource tablo
  • DataSource pivotTable
  • DataSource grafiği
  • DataSource formülü

BigQuery veri kaynağı tablosu ekleme

E-Tablolar düzenleyicisinde "ayıklama" olarak bilinen tablo nesnesi, veri kaynağından E-Tablolar'a statik bir veri dökümü içe aktarır. Pivot tabloya benzer şekilde, tablo belirtilir ve sol üst hücreye sabitlenir.

Aşağıdaki kod örneğinde, 1.000 satır ve iki sütundan (word ve word_count) oluşan bir veri kaynağı tablosu oluşturmak için spreadsheets.batchUpdate yönteminin ve UpdateCellsRequest'ın nasıl kullanılacağı gösterilmektedir.

"updateCells":{
   "rows":{
      "values":[
         {
            "dataSourceTable":{
               "dataSourceId":"DATA_SOURCE_ID",
               "columns":[
                  {
                     "name":"word"
                  },
                  {
                     "name":"word_count"
                  }
               ],
               "rowLimit":{
                  "value":1000
               },
               "columnSelectionType":"SELECTED"
            }
         }
      ]
   },
   "fields":"dataSourceTable"
}

DATA_SOURCE_ID değerini, veri kaynağını tanımlayan, e-tablo kapsamlı benzersiz bir kimlikle değiştirin.

Veri kaynağı tablosu oluşturulduktan sonra veriler hemen kullanılamaz. E-Tablolar düzenleyicisinde önizleme olarak gösterilir. BigQuery verilerini getirmek için veri kaynağı tablosunu yenilemeniz gerekir. Aynı batchUpdate içinde bir RefreshDataSourceRequest belirtebilirsiniz. Tüm veri kaynağı nesnelerinin benzer şekilde çalıştığını unutmayın. Daha fazla bilgi için Veri kaynağı nesnesini yenileme başlıklı makaleyi inceleyin.

Yenileme tamamlandıktan ve BigQuery verileri getirildikten sonra veri kaynağı tablosu aşağıdaki gibi doldurulur:

Shakespeare genel veri kümesindeki verileri gösteren veri kaynağı tablosu.

BigQuery veri kaynağına sahip bir özet tablo ekleme

Geleneksel bir pivot tablonun aksine, veri kaynağı pivot tablosu bir veri kaynağı tarafından desteklenir ve verilere sütun adına göre referans verir. Aşağıdaki kod örneğinde, spreadsheets.batchUpdate yönteminin ve UpdateCellsRequest işlevinin, toplam kelime sayısını korpusa göre gösteren bir pivot tablo oluşturmak için nasıl kullanılacağı gösterilmektedir.

"updateCells":{
   "rows":{
      "values":[
         {
            "pivotTable":{
               "dataSourceId":"DATA_SOURCE_ID",
               "rows":{
                  "dataSourceColumnReference":{
                     "name":"corpus"
                  },
                  "sortOrder":"ASCENDING"
               },
               "values":{
                  "summarizeFunction":"SUM",
                  "dataSourceColumnReference":{
                     "name":"word_count"
                  }
               }
            }
         }
      ]
   },
   "fields":"pivotTable"
    }

DATA_SOURCE_ID değerini, veri kaynağını tanımlayan, e-tablo kapsamlı benzersiz bir kimlikle değiştirin.

BigQuery verileri getirildikten sonra veri kaynağı pivot tablosu aşağıdaki gibi doldurulur:

Shakespeare herkese açık veri kümesindeki verileri gösteren veri kaynağı pivot tablosu.

BigQuery veri kaynağı grafiği ekleme

Aşağıdaki kod örneğinde, spreadsheets.batchUpdate yönteminin ve AddChartRequest kullanılarak, toplam kelime sayısını korpusa göre gösteren bir chartType SÜTUN veri kaynağı grafiğinin nasıl oluşturulacağı gösterilmektedir.

"addChart":{
   "chart":{
      "spec":{
         "title":"Corpus by word count",
         "basicChart":{
            "chartType":"COLUMN",
            "domains":[
               {
                  "domain":{
                     "columnReference":{
                        "name":"corpus"
                     }
                  }
               }
            ],
            "series":[
               {
                  "series":{
                     "columnReference":{
                        "name":"word_count"
                     },
                     "aggregateType":"SUM"
                  }
               }
            ]
         }
      },
      "dataSourceChartProperties":{
         "dataSourceId":"DATA_SOURCE_ID"
      }
   }
}

DATA_SOURCE_ID değerini, veri kaynağını tanımlayan, e-tablo kapsamlı benzersiz bir kimlikle değiştirin.

BigQuery verileri getirildikten sonra veri kaynağı grafiği aşağıdaki gibi oluşturulur:

Shakespeare herkese açık veri kümesindeki verileri gösteren veri kaynağı grafiği.

BigQuery veri kaynağı formülü ekleme

Aşağıdaki kod örneğinde, ortalama kelime sayısını hesaplamak için veri kaynağı formülü oluşturmak üzere spreadsheets.batchUpdate yönteminin ve UpdateCellsRequest işlevinin nasıl kullanılacağı gösterilmektedir.

"updateCells":{
   "rows":[
      {
         "values":[
            {
               "userEnteredValue":{
                  "formulaValue":"=AVERAGE(shakespeare!word_count)"
               }
            }
         ]
      }
   ],
   "fields":"userEnteredValue"
}

BigQuery verileri getirildikten sonra veri kaynağı formülü aşağıdaki gibi doldurulur:

Shakespeare herkese açık veri kümesindeki verileri gösteren veri kaynağı formülü.

BigQuery veri kaynağı nesnesini yenileme

Veri kaynağı nesnesini yenileyerek mevcut veri kaynağı spesifikasyonlarına ve nesne yapılandırmalarına göre BigQuery'den en son verileri getirebilirsiniz. RefreshDataSourceRequest öğesini çağırmak için spreadsheets.batchUpdate yöntemini kullanabilirsiniz. Ardından, DataSourceObjectReferences nesnesini kullanarak yenilenecek bir veya daha fazla nesne referansı belirtin.

Tek bir batchUpdate isteğinde hem veri kaynağı nesneleri oluşturabileceğinizi hem de bunları yenileyebileceğinizi unutmayın.

Looker veri kaynağını yönetme

Bu kılavuzda, Looker veri kaynağının nasıl ekleneceği, güncelleneceği veya silineceği, üzerinde nasıl pivot tablo oluşturulacağı ve nasıl yenileneceği gösterilmektedir.

Looker Bağlı E-Tablolar verilerini isteyen uygulamanız, Looker ile mevcut Google Hesabı bağlantınızı yeniden kullanır.

Looker veri kaynağı ekleme

Veri kaynağı eklemek için spreadsheets.batchUpdate yöntemini kullanarak bir AddDataSourceRequest sağlayın. İstek gövdesinde, dataSource alanının türü DataSource nesne olarak belirtilmelidir.

"addDataSource":{
   "dataSource":{
      "spec":{
         "looker":{
            "instance_uri":"INSTANCE_URI",
            "model":"MODEL",
            "explore":"EXPLORE"
         }
      }
   }
}

INSTANCE_URI, MODEL ve EXPLORE değerlerini sırasıyla geçerli bir Looker örneği URI'si, model adı ve keşif adıyla değiştirin.

Veri kaynağı oluşturulduktan sonra, seçilen keşfin yapısının önizlemesini sağlamak için ilişkili bir DATA_SOURCE sayfası oluşturulur. Bu yapı; görünümler, boyutlar, ölçüler ve alan açıklamalarını içerir.

AddDataSourceResponse aşağıdaki alanları içerir:

  • dataSource: Oluşturulan DataSource nesnesi. dataSourceId, e-tablo kapsamlı benzersiz bir kimliktir. Veri kaynağındaki her DataSource nesnesini oluşturmak için doldurulur ve referans verilir.

  • dataExecutionStatus: BigQuery verilerini önizleme sayfasına aktaran bir yürütmenin durumu. Daha fazla bilgi için Veri yürütme durumu bölümüne bakın.

Looker veri kaynağını güncelleme veya silme

spreadsheets.batchUpdate yöntemini kullanın ve buna göre bir UpdateDataSourceRequest veya DeleteDataSourceRequest isteği gönderin.

Looker veri kaynağı nesnelerini yönetme

Bir veri kaynağı e-tabloya eklendikten sonra, bu veri kaynağından bir veri kaynağı nesnesi oluşturulabilir. Looker veri kaynakları için yalnızca DataSource pivotTable nesnesi oluşturabilirsiniz.

Looker veri kaynaklarından DataSource formül, ayıklama ve grafik oluşturmak mümkün değildir.

Looker veri kaynağı nesnesini yenileme

Mevcut veri kaynağı özelliklerine ve nesne yapılandırmalarına göre Looker'dan en son verileri getirmek için veri kaynağı nesnesini yenileyebilirsiniz. RefreshDataSourceRequest öğesini çağırmak için spreadsheets.batchUpdate yöntemini kullanabilirsiniz. Ardından, DataSourceObjectReferences nesnesini kullanarak yenilenecek bir veya daha fazla nesne referansı belirtin.

Tek bir batchUpdate isteğinde hem veri kaynağı nesneleri oluşturabileceğinizi hem de bunları yenileyebileceğinizi unutmayın.

Veri yürütme durumu

Veri kaynakları oluşturduğunuzda veya veri kaynağı nesnelerini yenilediğinizde, BigQuery ya da Looker'dan verileri getirmek ve DataExecutionStatus içeren bir yanıt döndürmek için arka planda bir yürütme işlemi oluşturulur. Yürütme başarılı bir şekilde başlarsa DataExecutionState genellikle RUNNING durumundadır.

İşlem eşzamansız olduğundan uygulamanız, veri kaynağı nesnelerinin durumunu düzenli olarak almak için bir yoklama modeli uygulamalıdır. Durum SUCCEEDED veya FAILED durumuna dönene kadar spreadsheets.get yöntemini kullanın. Yürütme çoğu durumda hızlı bir şekilde tamamlanır ancak bu, veri kaynağınızın karmaşıklığına bağlıdır. Yürütme genellikle 10 dakikayı aşmaz.