Bağlı Sayfalar, E-Tablolar ile kullanılabilen yeni bir veri bağlama özelliğidir. Bu özelliği kullanarak, e-tablonuzdaki milyarlarca satırlık veriye erişip bu verileri analiz edebilir, görselleştirebilir ve paylaşabilirsiniz. Bağlı Sayfalar özelliğini kullanarak yapabileceğiniz diğer işlemler şunlardır:
- Tanıdık bir e-tablo arayüzünde iş ortaklarıyla, analistlerle veya diğer paydaşlarla ortak çalışma
- Kullanıcılara ortak çalışanları yetkilendirme izni verme
- Veri analizinde, .csv dosyalarını dışa aktarmak için ek işlem gerektirmeyen tek ve doğru bir kaynak sağlama
- Kullanıcıların IP adresi ve cihaz bilgileri gibi özelliklere dayanarak erişimi kısıtlayan bir hizmet çevresi içindeki verileri analiz etme
Bağlı Sayfalar'daki sorguları BigQuery veya Looker'da manuel olarak ta da tanımlı bir programla çalıştırabilirsiniz. E-Tablolar, bu sorguların sonuçlarını analiz edip paylaşabilmeniz için e-tablonuza kaydeder. BigQuery ile Bağlı Sayfalar'ı kullanma hakkında daha fazla bilgi edinmek için bu eğitim videolarını izleyin.
Bağlı Sayfalar sorgu etkinliklerini Drive günlük etkinlikleri'nde görüntüleyebilirsiniz.
Verileri analiz etmek için BigQuery'yi ayarlama
1. adım: Google Cloud'u etkinleştirinKuruluşunuzda Google Cloud etkinleştirilmiş olmalıdır. İlgili talimatları Bir kullanıcı, grup veya kuruluş birimi için etkinleştirilmiş uygulamaları görüntüleme başlıklı makalede bulabilirsiniz. Google Cloud'u etkinleştirmeniz gerekiyorsa Kullanıcılar için Google Cloud'u etkinleştirme veya devre dışı bırakma başlıklı makaleyi inceleyin.
BigQuery ile Bağlı Sayfalar'ı kullanmayla ilgili talimatlar için Google E-Tablolar'da BigQuery verilerini kullanmaya başlama başlıklı makaleyi inceleyin.
IAM (kimlik ve erişim yönetimi) rolleri, kullanıcıların erişebileceği verileri belirleyen izinleri atamak için kullanılır. E-Tablolar'da BigQuery projesi eklemek veya kullanmak için bir kullanıcının BigQuery'deki IAM rolü bigquery.user ya da bigquery.jobUser ve bigquery.dataViewer olmalıdır.
Bu roller hakkında bilgi edinmek için Önceden tanımlanmış BigQuery rolleri başlıklı makaleyi inceleyin.
Kullanıcıların yapabileceği işlemler e-tablo sahibinin izinlerine değil, IAM rollerine ve e-tablo izinlerine bağlıdır. Kuruluşunuz dışındaki kullanıcılar, kuruluşunuz kapsamındaki E-Tablolar içeriklerine izniniz olmadan erişemez.
E-Tablolar'daki işlemler | BigQuery'de gerekli IAM rolü | E-Tablolar'da gerekli izinler |
---|---|---|
BigQuery tablolarını ya da görünümlerini kullanarak grafikler, pivot tablolar, formüller veya ayıklama işlemleri oluşturun |
bigquery.user veyabigquery.jobUser ve bigquery.dataViewer |
Düzenleyici |
BigQuery verilerinden oluşturulan grafikleri, pivot tabloları, formülleri, ayıklama işlemlerini veya önizlemeleri görüntüleme | Yok | Düzenleyen veya görüntüleyen |
Özel BigQuery sorgusu oluşturma veya düzenleme |
bigquery.user veya bigquery.jobUser ve bigquery.dataViewer |
Düzenleyici |
Özel BigQuery sorgularını görüntüleme | Yok | Düzenleyen veya görüntüleyen |
Verileri BigQuery'den yenileme |
bigquery.user veya bigquery.jobUser ve bigquery.dataViewer |
Düzenleyici |
Veri kümelerinize IAM rollerini atamak için BigQuery konsolunu kullanmanız gerekir. Ayrıntılar için IAM ile kaynaklara erişimi kontrol etme başlıklı makaleyi inceleyin.
BigQuery verilerine hangi kullanıcıların erişebileceğini yetkilendirmek için IAM kullanmanın yanı sıra, kullanıcının IP adresi ve cihaz bilgileri gibi özelliklere dayanarak erişimi kısıtlayan bir hizmet çevresi oluşturmak için VPC Hizmet Kontrolleri'ni kullanabilirsiniz. Bağlı Sayfalar, VPC Hizmet Kontrolleri ile korunan BigQuery verilerine yalnızca E-Tablolar'ın sorgu sonuçlarını kullanıcı e-tablolarına kopyalamasına izin verecek şekilde yapılandırdığınız durumlarda erişebilir. Ayrıntılar için Erişim denetimi başlıklı makaleyi inceleyin.
Looker'ı verileri analiz edecek şekilde ayarlama
Bağlı Sayfalar'ı Looker ile kullanabilmek için Google Yönetici Konsolunuzda tek tek kontrol edilmeyen hizmetlere erişimi etkinleştirmeniz gerekir. Daha fazla bilgi edinmek için Tek tek denetlenmeyen hizmetlere erişimi yönetme başlıklı makaleye göz atın. Ayrıca bir Looker yöneticisinin, Looker yönetici arayüzünde Bağlı Sayfalar'ı etkinleştirmesi gerekir. Daha ayrıntılı talimatlar için Looker için Bağlı Sayfalar'ı kullanma başlıklı makaleyi inceleyin.
Kullanıcıların BigQuery için Bağlı Sayfalar'a erişim yetkisi vermesine izin verme
Kullanıcılara, BigQuery için Bağlı Sayfalar'a erişim yetkisi verme izni verebilirsiniz. Bu izin, kullanıcıların veri analizi yapmak ve sorgu çalıştırmak için diğer kullanıcılarla ortak çalışmasına olanak tanır.
Erişim yetkisi vermek için kullanıcıların sayfayı diğer kullanıcıyla paylaşması gerekir. Ancak bağlantı aracılığıyla herkese açık olarak paylaşılmış sayfalara erişim yetkisi verilemez. Erişim yetkisi veren kullanıcıyı ve sorgu çalıştıran kullanıcıyı Drive günlük etkinlikleri veya Cloud denetleme günlüklerinde inceleyebilirsiniz.
Yetki verilmiş erişimi etkinleştirme veya devre dışı bırakma
-
Google Yönetici konsolu hesabınızda oturum açın.
Yönetici hesabınızı (@gmail.com ile bitmeyen hesap) kullanarak oturum açın.
-
Yönetici Konsolu'nda Menü UygulamalarGoogle WorkspaceDrive ve DokümanlarÖzellikler ve Uygulamalar'a gidin.
- Bağlı Sayfalar'daki yetki verilmiş erişim özelliği bölümünde Düzenle'yi tıklayın.
- (İsteğe bağlı) Ayarı yalnızca bazı kullanıcılara uygulamak için yan tarafta bir kuruluş birimi (Genellikle departmanlar için kullanılır.) veya yapılandırma grubu (gelişmiş) seçin. Nasıl olduğunu göster
Grup ayarları, kuruluş birimlerini geçersiz kılar. Daha fazla bilgi
- Yetki ayarları bölümünde Bir e-tabloya erişim izni olan kullanıcıların, Bağlı Sayfalar için erişim yetkisini etkinleştirmesine izin verin'i işaretleyin veya işaretini kaldırın.
- Bir kuruluş birimini ya da grubu yapılandırıyorsanız Yalnızca belirli bir kuruluş birimi veya grup dahilindeki kullanıcılar yetkiyi kullanabilir'i seçin.
- Sayfaya erişimi olan tüm kullanıcıların erişim yetkisi vermesine izin vermek istiyorsanız Tüm kullanıcılar yetkiyi kullanabilir'i seçin.
Bu seçenek, kuruluşunuzun dışında olan ancak e-tabloya erişebilen kullanıcıları da kapsar.
-
Kaydet'i tıklayın. Alternatif olarak bir kuruluş birimi için Geçersiz kıl'ı tıklayabilirsiniz.
Devralınan değeri daha sonra geri yüklemek için Devral'ı (veya bir grup için Ayarlanmadı seçeneğini) tıklayın.
Yetki verme özelliğini etkinleştirdiğiniz takdirde, e-tablolara erişim yetkisi vermek için bu adımları uygulayabileceklerini kullanıcılarınıza bildirin.
Bağlı Sayfalar için günlük etkinliklerini görüntüleme
Bağlı Sayfalar; BigQuery ve Looker verilerine eriştiğinde, girişler Drive günlük etkinliğine de kaydedilir. Girişler, BigQuery erişimi için Cloud Audit Logs'a ve Looker erişimi için System Activity History Explore'a da kaydedilir. Günlükler, verilere kimin ne zaman eriştiğini gösterir.
Reports API'yi kullanarak Drive günlük etkinliklerini analiz etmeDrive günlük etkinliklerinin Google Yönetici Konsolu'nda nasıl analiz edileceğiyle ilgili ayrıntılar için Drive günlüğü etkinlik verilerine erişme başlıklı bölümü inceleyin.
Reports API'yi kullanarak, Bağlı Sayfalar sorgu etkinliklerini görüntüleyebilirsiniz. Aşağıdaki örnek, tüm Drive etkinliklerini Bağlı Sayfalar sorgu etkinliği türüne göre alır:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/drive?eventName=connected_sheets_query
Bu API çağrısına yapılan JSON yanıtının tamamı, bu sayfanın altındaki Tam JSON Yanıtı bölümünde gösterilir.
Sorguyu başlatan kullanıcı, işlemi gerçekleştiren olarak gösterilir.
"actor": {
"email": "collaborator@example.com",
"profileId": "user’s unique Google Workspace profile ID"
}
E-Tablolar, parametre olarak yürütülen sorgu hakkında ek bilgiler sağlar.
"parameters": [
{
"name": "execution_trigger",
"value": "sheets_ui"
},
{
"name": "query_type",
"value": "big_query"
},
{
"name": "data_connection_id",
"value": "The Cloud project ID"
},
{
"name": "execution_id",
"multiValue": [
"jobs/big_query_job_id"
]
},
{
"name": "delegating_principal",
"value": "trix01@scary.docsplustesting.com"
},
execution_trigger
alanı, sorgunun E-Tablolar'dan çağrılma şekline göre ayarlanır:
Etiket | Sorgunun yürütülme şekli |
---|---|
sheets_ui | E-Tablolar kullanıcı arayüzü üzerinden manuel olarak |
program | E-Tablolar'daki planlı yenileme özelliği üzerinden |
api | Sheets API üzerinden |
apps-script | Apps Komut Dosyası üzerinden |
query_type
alanı, veri bağlayıcıya göre ayarlanır.Etiket | Veri bağlayıcı |
---|---|
big_query | BigQuery |
looker | Looker |
data_connection_id
alanı, veri bağlantısının kimliğine göre ayarlanır. BigQuery için faturalandırma proje kimliği, Looker için örneğin URL'si kullanılır.
execution_id
, yürütülen sorgunun kimliğine göre ayarlanır.
Değer yapısı | Sorgu varlığı |
---|---|
jobs/<JOB_ID> | BigQuery İşi |
datasets/<DATASET_NAME>/tables/<TABLE_NAME> | BigQuery Tablosu |
query_tasks/<QUERY_TASK_ID> | Looker Sorgusu |
Kimlik bilgileri kullanılan kullanıcının e-posta adresi, günlüklerde delegating_principal
alanı olarak mevcuttur.
Tam JSON yanıtı
{
"kind": "admin#reports#activity",
"id": {
"time": "2022-10-26T17:33:51.929Z",
"uniqueQualifier": "report’s unique ID",
"applicationName": "drive",
"customerId": "ABC123xyz"
},
"actor": {
"email": "collaborator@example.com",
"profileId": "user’s unique Google Workspace profile ID"
},
"events": [
{
"type": "access",
"name": "connected_sheets_query",
"parameters": [
{
"name": "execution_trigger",
"value": "sheets_ui"
},
{
"name": "query_type",
"value": "big_query"
},
{
"name": "data_connection_id",
"value": "The Cloud project ID"
},
{
"name": "execution_id",
"multiValue": [
"jobs/big_query_job_id"
]
},
{
"name": "doc_id",
"value": "aBC-123-xYz"
},
{
"name": "doc_type",
"value": "spreadsheet"
},
{
"name": "is_encrypted",
"boolValue": false
},
{
"name": "doc_title",
"value": "Document title"
},
{
"name": "visibility",
"value": "shared_internally"
},
{
"name": "actor_is_collaborator_account",
"boolValue": false
},
{
"name": "delegating_principal",
"value": "owner@example.com"
},
{
"name": "owner",
"value": "owner@example.com"
},
{
"name": "owner_is_shared_drive",
"boolValue": false
},
{
"name": "owner_is_team_drive",
"boolValue": false
}
]
}
]
}
Her e-tablonun URL'sinde benzersiz bir E-Tablo kimliği bulunur. BigQueryAuditMetadata biçimindeki günlük girişleri, BigQuery veri erişimi isteğinin gönderildiği e-tablonun kimliğini içerir.
Günlükleri almak ve analiz etmek için Google Cloud Console'daki Günlük Gezgini'ni kullanarak sorgular oluşturabilirsiniz. Günlük Gezgini'nde şunları girin:
protoPayload.metadata.firstPartyAppMetadata.sheetsMetadata.docId
!= NULL_VALUE
Aşağıdaki örnekte gösterildiği gibi, bu kod kullanılarak boş olmayan e-tablo kimliği içeren girişler gösterilir:
metadata: {
@type: "type.googleapis.com/google.cloud.audit.BigQueryAuditMetadata"
firstPartyAppMetadata: {
sheetsMetadata: {
docId: "aBC-123_xYz"
}
}
E-Tablolar, iş etiketlerini kullanarak sorgu işlerine bilgi ekler. Aşağıdaki örnekte gösterildiği gibi, bu etiketler analiz etmeniz için daha fazla veri sağlayabilir:
jobInsertion: {
job: {
jobConfig: {
labels: {
sheets_access_type: "normal"
sheets_connector: "connected_sheets"
sheets_trigger: "user"
}
sheets_trigger alanının değeri, sorgunun E-Tablolar'dan çağrılma şekline göre ayarlanır:
Etiket | Sorgunun yürütülme şekli |
---|---|
kullanıcı | E-Tablolar kullanıcı arayüzü üzerinden manuel olarak |
program | E-Tablolar'daki planlı yenileme özelliği üzerinden |
api | Sheets API üzerinden |
apps-script | Apps Komut Dosyası üzerinden |
Örneğin, Bağlı Sayfalar'ın planlı yenilemelerine karşılık gelen girişleri bulmak için Günlük Gezgini'nde aşağıdaki sorguyu kullanın:
protoPayload.metadata.firstPartyAppMetadata.sheetsMetadata.docId
!= NULL_VALUE
protoPayload.metadata.jobInsertion.job.jobConfig.labels.sheets_trigger
= "schedule"
Yetki verilmiş erişim etkinleştirildiyse sorguyu çalıştırmak için kimlik bilgilerinden yararlanılan kullanıcının e-posta adresini günlüklerde bulabilirsiniz. Ayrıca, aşağıdaki örnekte gösterildiği gibi, sorguyu tetikleyen kullanıcının e-posta adresini de bulabilirsiniz:
"authenticationInfo": {
"principalEmail": "sahip@example.com",
"serviceAccountDelegationInfo": [
{
"firstPartyPrincipal": {
"principalEmail": "ortakcalisan@example.com",
"serviceMetadata": {
"service": "sheets"
}
}
}
]
}
Not: serviceAccountDelegationInfo
alanı yalnızca sorgu için yetki verilmiş erişim kullanıldıysa gösterilir. Bu durumda, erişim yetkisi veren kişi principalEmail
altında listelenen kişidir.
Daha ayrıntılı dokümanlar için Günlük Gezgini'ni kullanma ve Günlük Gezgini'nde sorgu oluşturma başlıklı makaleleri inceleyin.
BigQuery denetleme günlükleri, e-tablo kimlikleri, BigQueryAuditMetadata biçimi, SheetsMetadata, e-tabloları paylaşma ve Google Sheets API hakkında daha fazla bilgi edinin.
- Looker örneğinizde, sol tarafta KeşfetGeçmiş'i tıklayın.
- Alan Bul bölümünde, bu alanı veri kümesine eklemek için API İstemci Adı yazıp Filtrele'yi tıklayın.
- Filtreler bölümünde, eşittir'i seçin ve yanındaki alana Bağlı Sayfalar yazın.
- Alan Bul bölümünde, bu alanı veri kümesine eklemek için Bağlı Sayfalar E-Tablo Kimliği'ni girin.
- Alan Bul bölümünde, bu alanı veri kümesine eklemek için Bağlı Sayfalar Tetikleyicisi yazın.
- Alan Bul bölümünde, bu alanı veri kümesine eklemek için Geçmiş Parçası yazın.
- Geçmiş Parçası, Drive günlük etkinliklerinde günlüğe kaydedilen QUERY_TASK_ID ile eşdeğerdir. Drive günlüğünde belirli bir sorguyu bulmak istiyorsanız bu alana bir filtre ekleyin.
- (İsteğe bağlı) Kullanıcı Adı ve Geçmişin Oluşturulma Tarihi gibi ek alanları veri kümesine eklemek için bunları seçin.
- (İsteğe bağlı) Eklemek istediğiniz filtreleri seçin.
Örneğin, Geçmişin Oluşturulma Tarihi'ni son 7 gün içinde olarak filtreleyebilir veya yalnızca belirli bir e-tablo kimliğinden başlatılan Looker sorgularını görmek için E-Tablo Kimliği üzerinde filtreleme yapabilirsiniz. - Çalıştır'ı tıklayın.
Sorun giderme
E-Tablolar kilitleniyorsaSayfanın üst kısmından Geri Bildirim Gönder'i tıklayın.
E-Tablolar dosyalarında, BigQuery verileriyle ilgili güncellemeleri Bağlı Sayfalar'a almak için Yenile'yi tıklayın. Bağlı Sayfalar'daki her öğeyi yenilemek için VeriVeri bağlayıcılarıVerileri güncelleTümünü yenile'yi tıklayın.
E-Tablolar dosyalarında kuruluşunuz için belirli izinler ayarladıysanız (ör. kuruluşunuzun dışından kullanıcıların E-Tablolar dosyalarına erişimini kısıtlamadıysanız) izni olmayan kullanıcılar Bağlı Sayfalar dosyalarını açamaz. İzinleri değiştirmek için Drive kullanıcılarının paylaşım izinlerini belirleme başlıklı makaleye göz atın.
Sorun yaşamaya devam ediyorsanız Google E-Tablolar'da BigQuery verileriyle ilgili sorunları düzeltme ve Looker için Bağlı Sayfalar ile ilgili sorunları giderme başlıklı makaleleri inceleyin.