MCP Tools Reference: bigquery.googleapis.com

Alat: get_dataset_info

Mendapatkan informasi metadata tentang set data BigQuery.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP get_dataset_info.

Permintaan Curl 
                  
curl --location 'https://bigquery.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_dataset_info",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Permintaan set data.

Representasi JSON 
{
  "projectId": string,
  "datasetId": string
}
Kolom
projectId

string

Wajib. Project ID permintaan set data.
datasetId

string

Wajib. ID set data dari permintaan set data.

Skema Output

Mewakili set data BigQuery.

Representasi JSON 
{
  "kind": string,
  "etag": string,
  "id": string,
  "selfLink": string,
  "datasetReference": {
    object (DatasetReference)
  },
  "friendlyName": string,
  "description": string,
  "defaultTableExpirationMs": string,
  "defaultPartitionExpirationMs": string,
  "labels": {
    string: string,
    ...
  },
  "access": [
    {
      object (Access)
    }
  ],
  "creationTime": string,
  "lastModifiedTime": string,
  "location": string,
  "defaultEncryptionConfiguration": {
    object (EncryptionConfiguration)
  },
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean,
  "type": string,
  "linkedDatasetSource": {
    object (LinkedDatasetSource)
  },
  "linkedDatasetMetadata": {
    object (LinkedDatasetMetadata)
  },
  "externalDatasetReference": {
    object (ExternalDatasetReference)
  },
  "externalCatalogDatasetOptions": {
    object (ExternalCatalogDatasetOptions)
  },
  "isCaseInsensitive": boolean,
  "defaultCollation": string,
  "defaultRoundingMode": enum (RoundingMode),
  "maxTimeTravelHours": string,
  "tags": [
    {
      object (GcpTag)
    }
  ],
  "storageBillingModel": enum (StorageBillingModel),
  "restrictions": {
    object (RestrictionConfig)
  },
  "resourceTags": {
    string: string,
    ...
  }
}
Kolom
kind

string

Hanya output. Jenis resource.
etag

string

Hanya output. Hash resource.
id

string

Hanya output. Nama unik set data yang sepenuhnya memenuhi syarat dalam format projectId:datasetId. Nama set data tanpa nama project diberikan di kolom datasetId. Saat membuat set data baru, biarkan kolom ini kosong, dan tentukan kolom datasetId.
selfLink

string

Hanya output. URL yang dapat digunakan untuk mengakses resource lagi. Anda dapat menggunakan URL ini dalam permintaan Get atau Update ke resource.
datasetReference

object (DatasetReference)

Wajib. Referensi yang mengidentifikasi set data.
friendlyName

string

Opsional. Nama deskriptif untuk set data.
description

string

Opsional. Deskripsi set data yang mudah dipahami pengguna.
defaultTableExpirationMs

string (Int64Value format)

Opsional. Masa aktif default semua tabel dalam set data, dalam milidetik. Nilai masa aktif minimum adalah 3.600.000 milidetik (satu jam). Untuk menghapus masa berlaku default yang ada dengan permintaan PATCH, tetapkan ke 0. Setelah properti ini ditetapkan, semua tabel yang baru dibuat dalam set data akan memiliki properti expirationTime yang ditetapkan ke waktu pembuatan ditambah nilai dalam properti ini, dan perubahan nilai hanya akan memengaruhi tabel baru, bukan tabel yang sudah ada. Saat expirationTime untuk tabel tertentu tercapai, tabel tersebut akan dihapus secara otomatis. Jika expirationTime tabel diubah atau dihapus sebelum tabel berakhir, atau jika Anda memberikan expirationTime eksplisit saat membuat tabel, nilai tersebut akan lebih diprioritaskan daripada waktu habis masa berlaku default yang ditunjukkan oleh properti ini.
defaultPartitionExpirationMs

string (Int64Value format)

Masa berlaku partisi default ini, dinyatakan dalam milidetik.

Saat tabel berpartisi waktu baru dibuat dalam set data tempat properti ini disetel, tabel akan mewarisi nilai ini, yang disebarkan sebagai properti TimePartitioning.expirationMs pada tabel baru. Jika Anda menetapkan TimePartitioning.expirationMs secara eksplisit saat membuat tabel, defaultPartitionExpirationMs set data yang berisi akan diabaikan.

Saat membuat tabel berpartisi, jika defaultPartitionExpirationMs ditetapkan, nilai defaultTableExpirationMs akan diabaikan dan tabel tidak akan mewarisi batas waktu habis masa berlaku tabel.
labels

map (key: string, value: string)

Label yang terkait dengan set data ini. Anda dapat menggunakannya untuk mengatur dan mengelompokkan set data. Anda dapat menetapkan properti ini saat menyisipkan atau memperbarui set data. Lihat Membuat dan Memperbarui Label Set Data untuk mengetahui informasi selengkapnya.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
access[]

object (Access)

Opsional. Array objek yang menentukan akses set data untuk satu atau beberapa entitas. Anda dapat menetapkan properti ini saat menyisipkan atau memperbarui set data untuk mengontrol siapa yang diizinkan mengakses data. Jika tidak ditentukan pada saat pembuatan set data, BigQuery akan menambahkan akses set data default untuk entity berikut: access.specialGroup: projectReaders; access.role: READER; access.specialGroup: projectWriters; access.role: WRITER; access.specialGroup: projectOwners; access.role: OWNER; access.userByEmail: [email pembuat set data]; access.role: OWNER; Jika Anda memperbaiki set data, kolom ini akan digantikan oleh kolom akses set data yang diperbaiki. Untuk menambahkan entity, Anda harus memberikan seluruh array akses yang ada selain entity baru yang ingin Anda tambahkan.
creationTime

string (int64 format)

Hanya output. Waktu saat set data ini dibuat, dalam milidetik sejak epoch.
lastModifiedTime

string (int64 format)

Hanya output. Tanggal saat set data ini terakhir diubah, dalam milidetik sejak epoch.
location

string

Lokasi geografis tempat set data harus berada. Lihat https://cloud.google.com/bigquery/docs/locations untuk mengetahui lokasi yang didukung.
defaultEncryptionConfiguration

object (EncryptionConfiguration)

Kunci enkripsi default untuk semua tabel dalam set data. Setelah properti ini ditetapkan, kunci enkripsi semua tabel yang baru dibuat dalam set data akan ditetapkan ke nilai ini, kecuali jika permintaan atau kueri pembuatan tabel secara eksplisit menggantikan kunci tersebut.
satisfiesPzs

boolean

Hanya output. Dipesan untuk penggunaan di masa mendatang.
satisfiesPzi

boolean

Hanya output. Dipesan untuk penggunaan di masa mendatang.
type

string

Hanya output. Sama seperti type di ListFormatDataset. Jenis set data, salah satunya:

  • DEFAULT - hanya dapat diakses oleh pemilik dan akun yang diberi otorisasi,
  • PUBLIK - dapat diakses oleh semua orang,
  • TERTAUT - set data tertaut,
  • EKSTERNAL - set data dengan definisi dalam katalog metadata eksternal.
linkedDatasetSource

object (LinkedDatasetSource)

Opsional. Referensi set data sumber saat set data berjenis LINKED. Untuk semua jenis set data lainnya, parameter ini tidak ditetapkan. Kolom ini tidak dapat diperbarui setelah ditetapkan. Setiap upaya untuk memperbarui kolom ini menggunakan Operasi API Update dan Patch akan diabaikan.
linkedDatasetMetadata

object (LinkedDatasetMetadata)

Hanya output. Metadata tentang LinkedDataset. Diisi saat jenis set data adalah LINKED.
externalDatasetReference

object (ExternalDatasetReference)

Opsional. Referensi ke set data eksternal hanya baca yang ditentukan dalam katalog data di luar BigQuery. Diisi jika jenis set data adalah EXTERNAL.
externalCatalogDatasetOptions

object (ExternalCatalogDatasetOptions)

Opsional. Opsi yang menentukan set data yang kompatibel dengan open source yang ada di katalog BigQuery. Berisi metadata database, skema, atau namespace open source yang diwakili oleh set data saat ini.
isCaseInsensitive

boolean

Opsional. TRUE jika set data dan nama tabelnya tidak peka huruf besar/kecil, atau FALSE jika sebaliknya. Secara default, nilainya adalah FALSE, yang berarti nama set data dan tabelnya peka huruf besar/kecil. Kolom ini tidak memengaruhi referensi rutin.
defaultCollation

string

Opsional. Menentukan spesifikasi kolasi default untuk tabel mendatang yang dibuat dalam set data. Jika tabel dibuat dalam set data ini tanpa kolasi default tingkat tabel, tabel akan mewarisi kolasi default set data, yang diterapkan ke kolom string yang tidak memiliki kolasi eksplisit yang ditentukan. Perubahan pada kolom ini hanya memengaruhi tabel yang dibuat setelahnya, dan tidak mengubah tabel yang ada. Nilai-nilai berikut didukung:

  • 'und:ci': lokalitas tidak ditentukan, tidak peka huruf besar/kecil.
  • '': string kosong. Default ke perilaku peka huruf besar/kecil.
defaultRoundingMode

enum (RoundingMode)

Opsional. Menentukan spesifikasi mode pembulatan default dari tabel baru yang dibuat dalam set data ini. Selama pembuatan tabel, jika kolom ini ditentukan, tabel dalam set data ini akan mewarisi mode pembulatan default set data. Menetapkan mode pembulatan default pada tabel akan menggantikan opsi ini. Tabel yang ada dalam set data tidak terpengaruh. Jika kolom ditentukan selama pembuatan tabel tersebut, kolom akan langsung mewarisi mode pembulatan default tabel, kecuali jika ditentukan lain.
maxTimeTravelHours

string (Int64Value format)

Opsional. Menentukan periode perjalanan waktu dalam jam. Nilainya dapat berkisar dari 48 hingga 168 jam (2 hingga 7 hari). Nilai defaultnya adalah 168 jam jika tidak ditetapkan.
tags[]
(deprecated)

object (GcpTag)

Hanya output. Tag untuk set data. Untuk memberikan tag sebagai input, gunakan kolom resourceTags.
storageBillingModel

enum (StorageBillingModel)

Opsional. Memperbarui storage_billing_model untuk set data.
restrictions

object (RestrictionConfig)

Opsional. Hanya output. Konfigurasi pembatasan untuk semua tabel dan set data. Jika disetel, batasi akses tertentu pada set data dan semua tabelnya berdasarkan konfigurasi. Lihat Egress data untuk mengetahui detail selengkapnya.
resourceTags

map (key: string, value: string)

Opsional. Tag yang dilampirkan ke set data ini. Kunci tag bersifat unik secara global. Kunci tag diharapkan dalam format namespace, misalnya "123456789012/environment" dengan 123456789012 adalah ID resource project atau organisasi induk untuk kunci tag ini. Nilai tag diharapkan berupa nama pendek, misalnya "Produksi". Lihat Definisi tag untuk mengetahui detail selengkapnya.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Representasi JSON 
{
  "datasetId": string,
  "projectId": string,
  "datasetIdAlternative": [
    string
  ],
  "projectIdAlternative": [
    string
  ]
}
Kolom
datasetId

string

Wajib. ID unik untuk set data ini, tanpa nama project. ID hanya boleh berisi huruf (a-z, A-Z), angka (0-9), atau garis bawah (_). Panjang maksimumnya adalah 1.024 karakter.
projectId

string

Opsional. ID project yang berisi set data ini.
datasetIdAlternative[]

string

Kolom ini tidak boleh digunakan.
projectIdAlternative[]

string

Kolom ini tidak boleh digunakan.
Representasi JSON 
{
  "value": string
}
Kolom
value

string

Nilai string.
Representasi JSON 
{
  "value": string
}
Kolom
value

string (int64 format)

Nilai int64.
Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string
Representasi JSON 
{
  "role": string,
  "userByEmail": string,
  "groupByEmail": string,
  "domain": string,
  "specialGroup": string,
  "iamMember": string,
  "view": {
    object (TableReference)
  },
  "routine": {
    object (RoutineReference)
  },
  "dataset": {
    object (DatasetAccessEntry)
  },
  "condition": {
    object (google.type.Expr)
  }
}
Kolom
role

string

ID peran IAM yang harus diberikan kepada pengguna, grup, atau domain yang ditentukan dalam entri akses ini. Pemetaan lama berikut akan diterapkan:

  • OWNER: roles/bigquery.dataOwner
  • WRITER: roles/bigquery.dataEditor
  • READER: roles/bigquery.dataViewer

Kolom ini akan menerima salah satu format di atas, tetapi hanya akan menampilkan format lama. Misalnya, jika Anda menyetel kolom ini ke "roles/bigquery.dataOwner", kolom ini akan ditampilkan kembali sebagai "OWNER".
userByEmail

string

[Pilih salah satu] Alamat email pengguna yang akan diberi akses. Misalnya: fred@example.com. Dipetakan ke anggota kebijakan IAM "user:EMAIL" atau "serviceAccount:EMAIL".
groupByEmail

string

[Pilih salah satu] Alamat email Grup Google untuk memberikan akses. Dipetakan ke anggota kebijakan IAM "group:GROUP".
domain

string

[Pilih salah satu] Domain yang akan diberi akses. Setiap pengguna yang login dengan domain yang ditentukan akan diberi akses yang ditentukan. Contoh: "example.com". Dipetakan ke anggota kebijakan IAM "domain:DOMAIN".
specialGroup

string

[Pilih salah satu] Grup khusus untuk memberikan akses. Nilai yang memungkinkan mencakup:

  • projectOwners: Pemilik project yang melampirkan.
  • projectReaders: Pembaca project yang mencakup.
  • projectWriters: Penulis project yang mencakup.
  • allAuthenticatedUsers: Semua pengguna BigQuery terautentikasi.

Dipetakan ke anggota IAM dengan nama serupa.
iamMember

string

[Pilih salah satu] Jenis anggota lain yang muncul dalam Kebijakan IAM, tetapi bukan pengguna, grup, domain, atau grup khusus.
view

object (TableReference)

[Pilih salah satu] Tampilan dari set data lain yang akan diberi akses. Kueri yang dijalankan terhadap tampilan tersebut akan memiliki akses baca ke tampilan/tabel/rutinitas dalam set data ini. Kolom peran tidak diperlukan jika kolom ini disetel. Jika tampilan tersebut diperbarui oleh pengguna mana pun, akses ke tampilan harus diberikan lagi melalui operasi update.
routine

object (RoutineReference)

[Pilih salah satu] Rutinitas dari set data lain untuk memberikan akses ke. Kueri yang dijalankan terhadap rutinitas tersebut akan memiliki akses baca ke tampilan/tabel/rutinitas dalam set data ini. Saat ini hanya UDF yang didukung. Kolom peran tidak diperlukan jika kolom ini disetel. Jika rutinitas tersebut diperbarui oleh pengguna mana pun, akses ke rutinitas harus diberikan lagi melalui operasi update.
dataset

object (DatasetAccessEntry)

[Pilih salah satu] Pemberian otorisasi semua resource dari jenis tertentu dalam set data tertentu untuk mengakses set data ini. Saat ini hanya tampilan yang didukung. Kolom peran tidak diperlukan jika kolom ini disetel. Jika set data tersebut dihapus dan dibuat ulang, aksesnya harus diberikan lagi melalui operasi pembaruan.
condition

object (google.type.Expr)

Opsional. Kondisi untuk binding. Jika ekspresi CEL di kolom ini benar (true), binding akses ini akan dipertimbangkan
Representasi JSON 
{
  "projectId": string,
  "datasetId": string,
  "tableId": string,
  "projectIdAlternative": [
    string
  ],
  "datasetIdAlternative": [
    string
  ],
  "tableIdAlternative": [
    string
  ]
}
Kolom
projectId

string

Wajib. ID project yang berisi tabel ini.
datasetId

string

Wajib. ID set data yang berisi tabel ini.
tableId

string

Wajib. ID tabel. ID dapat berisi karakter Unicode dalam kategori L (huruf), M (tanda), N (angka), Pc (penghubung, termasuk garis bawah), Pd (tanda pisah), dan Zs (spasi). Untuk mengetahui informasi selengkapnya, lihat Kategori Umum. Panjang maksimumnya adalah 1.024 karakter. Operasi tertentu memungkinkan penambahan akhiran ID tabel dengan dekorator partisi, seperti sample_table$20190123.
projectIdAlternative[]

string

Kolom ini tidak boleh digunakan.
datasetIdAlternative[]

string

Kolom ini tidak boleh digunakan.
tableIdAlternative[]

string

Kolom ini tidak boleh digunakan.
Representasi JSON 
{
  "projectId": string,
  "datasetId": string,
  "routineId": string
}
Kolom
projectId

string

Wajib. ID project yang berisi rutinitas ini.
datasetId

string

Wajib. ID set data yang berisi rutinitas ini.
routineId

string

Wajib. ID rutinitas. ID hanya boleh berisi huruf (a-z, A-Z), angka (0-9), atau garis bawah (_). Panjang maksimumnya adalah 256 karakter.
Representasi JSON 
{
  "dataset": {
    object (DatasetReference)
  },
  "targetTypes": [
    enum (TargetType)
  ]
}
Kolom
dataset

object (DatasetReference)

Set data yang berlaku untuk entri ini
targetTypes[]

enum (TargetType)

Resource mana dalam set data yang berlaku untuk entri ini. Saat ini, hanya penayangan yang didukung, tetapi jenis target tambahan dapat ditambahkan di masa mendatang.
Representasi JSON 
{
  "expression": string,
  "title": string,
  "description": string,
  "location": string
}
Kolom
expression

string

Representasi tekstual ekspresi dalam sintaksis Common Expression Language.
title

string

Opsional. Judul untuk ekspresi, yaitu string pendek yang menjelaskan tujuannya. Ini dapat digunakan misalnya di UI yang memungkinkan untuk memasukkan ekspresi.
description

string

Opsional. Deskripsi ekspresi. Ini adalah teks yang lebih panjang yang menjelaskan ekspresi, misalnya saat kursor diarahkan ke teks tersebut di UI.
location

string

Opsional. String yang menunjukkan lokasi ekspresi untuk pelaporan error, misalnya nama file dan posisi dalam file.
Representasi JSON 
{
  "kmsKeyName": string
}
Kolom
kmsKeyName

string

Opsional. Menjelaskan kunci enkripsi Cloud KMS yang akan digunakan untuk melindungi tabel BigQuery tujuan. Akun Layanan BigQuery yang terkait dengan project Anda memerlukan akses ke kunci enkripsi ini.
Representasi JSON 
{
  "value": boolean
}
Kolom
value

boolean

Nilai bool.
Representasi JSON 
{
  "sourceDataset": {
    object (DatasetReference)
  }
}
Kolom
sourceDataset

object (DatasetReference)

Referensi set data sumber berisi nomor project, bukan ID project.
Representasi JSON 
{
  "linkState": enum (LinkState)
}
Kolom
linkState

enum (LinkState)

Hanya output. Menentukan apakah Set Data Tertaut saat ini dalam status tertaut atau tidak.
Representasi JSON 
{
  "externalSource": string,
  "connection": string
}
Kolom
externalSource

string

Wajib. Sumber eksternal yang mendukung set data ini.
connection

string

Wajib. ID koneksi yang digunakan untuk mengakses external_source.

Format: projects/{project_id}/locations/{location_id}/connections/{connection_id}
Representasi JSON 
{
  "parameters": {
    string: string,
    ...
  },
  "defaultStorageLocationUri": string
}
Kolom
parameters

map (key: string, value: string)

Opsional. Peta key-value pair yang menentukan parameter dan properti skema open source. Ukuran maksimum 2 MiB.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
defaultStorageLocationUri

string

Opsional. URI lokasi penyimpanan untuk semua tabel dalam set data. Setara dengan database locationUri metastore Hive. Panjang maksimum 1024 karakter.
Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string
Representasi JSON 
{
  "tagKey": string,
  "tagValue": string
}
Kolom
tagKey

string

Wajib. Nama panggilan dengan namespace dari kunci tag, misalnya "12345/environment" dengan 12345 adalah ID org.
tagValue

string

Wajib. Nama pendek yang mudah diingat untuk nilai tag, misalnya "produksi".
Representasi JSON 
{
  "type": enum (RestrictionType)
}
Kolom
type

enum (RestrictionType)

Hanya output. Menentukan jenis batasan set data/tabel.
Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌