MCP Tools Reference: bigquery.googleapis.com

Alat: get_table_info

Mendapatkan informasi metadata tentang tabel BigQuery.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP get_table_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_table_info",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Permintaan untuk tabel.

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

string

Wajib. Project ID permintaan tabel.
datasetId

string

Wajib. ID set data permintaan tabel.
tableId

string

Wajib. ID tabel permintaan tabel.

Skema Output

Representasi JSON 
{
  "kind": string,
  "etag": string,
  "id": string,
  "selfLink": string,
  "tableReference": {
    object (TableReference)
  },
  "friendlyName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "schema": {
    object (TableSchema)
  },
  "timePartitioning": {
    object (TimePartitioning)
  },
  "rangePartitioning": {
    object (RangePartitioning)
  },
  "clustering": {
    object (Clustering)
  },
  "requirePartitionFilter": boolean,
  "numBytes": string,
  "numPhysicalBytes": string,
  "numLongTermBytes": string,
  "numRows": string,
  "creationTime": string,
  "expirationTime": string,
  "lastModifiedTime": string,
  "type": string,
  "view": {
    object (ViewDefinition)
  },
  "materializedView": {
    object (MaterializedViewDefinition)
  },
  "materializedViewStatus": {
    object (MaterializedViewStatus)
  },
  "externalDataConfiguration": {
    object (ExternalDataConfiguration)
  },
  "biglakeConfiguration": {
    object (BigLakeConfiguration)
  },
  "managedTableType": enum (ManagedTableType),
  "location": string,
  "streamingBuffer": {
    object (Streamingbuffer)
  },
  "encryptionConfiguration": {
    object (EncryptionConfiguration)
  },
  "snapshotDefinition": {
    object (SnapshotDefinition)
  },
  "defaultCollation": string,
  "defaultRoundingMode": enum (RoundingMode),
  "cloneDefinition": {
    object (CloneDefinition)
  },
  "numTimeTravelPhysicalBytes": string,
  "numTotalLogicalBytes": string,
  "numActiveLogicalBytes": string,
  "numLongTermLogicalBytes": string,
  "numCurrentPhysicalBytes": string,
  "numTotalPhysicalBytes": string,
  "numActivePhysicalBytes": string,
  "numLongTermPhysicalBytes": string,
  "numPartitions": string,
  "maxStaleness": string,
  "restrictions": {
    object (RestrictionConfig)
  },
  "tableConstraints": {
    object (TableConstraints)
  },
  "resourceTags": {
    string: string,
    ...
  },
  "tableReplicationInfo": {
    object (TableReplicationInfo)
  },
  "replicas": [
    {
      object (TableReference)
    }
  ],
  "externalCatalogTableOptions": {
    object (ExternalCatalogTableOptions)
  },

  // Union field _partition_definition can be only one of the following:
  "partitionDefinition": {
    object (PartitioningDefinition)
  }
  // End of list of possible types for union field _partition_definition.
}
Kolom
kind

string

Jenis ID resource.
etag

string

Hanya output. Hash resource ini.
id

string

Hanya output. ID buram yang mengidentifikasi tabel secara unik.
selfLink

string

Hanya output. URL yang dapat digunakan untuk mengakses kembali resource ini.
tableReference

object (TableReference)

Wajib. Referensi yang menjelaskan ID tabel ini.
friendlyName

string

Opsional. Nama deskriptif untuk tabel ini.
description

string

Opsional. Deskripsi tabel ini yang mudah dipahami pengguna.
labels

map (key: string, value: string)

Label yang terkait dengan tabel ini. Anda dapat menggunakannya untuk mengatur dan mengelompokkan tabel. Kunci dan nilai label tidak boleh lebih dari 63 karakter, hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda hubung. Karakter internasional diperbolehkan. Nilai label bersifat opsional. Kunci label harus diawali dengan huruf dan setiap label dalam daftar harus memiliki kunci yang berbeda.

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

object (TableSchema)

Opsional. Menjelaskan skema tabel ini.
timePartitioning

object (TimePartitioning)

Jika ditentukan, mengonfigurasi partisi berbasis waktu untuk tabel ini.
rangePartitioning

object (RangePartitioning)

Jika ditentukan, mengonfigurasi partisi rentang untuk tabel ini.
clustering

object (Clustering)

Spesifikasi pengelompokan untuk tabel. Harus ditentukan dengan partisi berbasis waktu, data dalam tabel akan dipartisi terlebih dahulu, lalu dikelompokkan.
requirePartitionFilter

boolean

Opsional. Jika disetel ke benar (true), kueri atas tabel ini memerlukan filter partisi yang dapat digunakan untuk penghapusan partisi agar dapat ditentukan.
numBytes

string (Int64Value format)

Hanya output. Ukuran tabel ini dalam byte logis, tidak termasuk data apa pun dalam buffer streaming.
numPhysicalBytes

string (Int64Value format)

Hanya output. Ukuran fisik tabel ini dalam byte. Hal ini mencakup penyimpanan yang digunakan untuk perjalanan waktu.
numLongTermBytes

string (Int64Value format)

Hanya output. Jumlah byte logis dalam tabel yang dianggap sebagai "penyimpanan jangka panjang".
numRows

string (UInt64Value format)

Hanya output. Jumlah baris data dalam tabel ini, tidak termasuk data apa pun dalam buffer streaming.
creationTime

string (int64 format)

Hanya output. Waktu saat tabel ini dibuat, dalam milidetik sejak epoch.
expirationTime

string (Int64Value format)

Opsional. Waktu saat tabel ini berakhir, dalam milidetik sejak epoch. Jika tidak ada, tabel akan tetap ada tanpa batas waktu. Tabel yang masa berlakunya sudah habis akan dihapus dan penyimpanannya akan diklaim kembali. Properti defaultTableExpirationMs dari set data yang mencakup dapat digunakan untuk menetapkan expirationTime default pada tabel yang baru dibuat.
lastModifiedTime

string (uint64 format)

Hanya output. Waktu saat tabel ini terakhir diubah, dalam milidetik sejak epoch.
type

string

Hanya output. Menjelaskan jenis tabel. Nilai-nilai berikut didukung:

  • TABLE: Tabel BigQuery normal.
  • VIEW: Tabel virtual yang ditentukan oleh kueri SQL.
  • EXTERNAL: Tabel yang mereferensikan data yang disimpan dalam sistem penyimpanan eksternal, seperti Google Cloud Storage.
  • MATERIALIZED_VIEW: Tampilan yang telah dihitung sebelumnya yang ditentukan oleh kueri SQL.
  • SNAPSHOT: Tabel BigQuery yang tidak dapat diubah yang menyimpan isi tabel dasar pada waktu tertentu. Lihat informasi tambahan tentang snapshot tabel.

Nilai defaultnya adalah TABLE.
view

object (ViewDefinition)

Opsional. Definisi tampilan.
materializedView

object (MaterializedViewDefinition)

Opsional. Definisi tampilan terwujud.
materializedViewStatus

object (MaterializedViewStatus)

Hanya output. Status tampilan terwujud.
externalDataConfiguration

object (ExternalDataConfiguration)

Opsional. Menjelaskan format data, lokasi, dan properti lain dari tabel yang disimpan di luar BigQuery. Dengan menentukan properti ini, sumber data kemudian dapat dikueri seolah-olah merupakan tabel BigQuery standar.
biglakeConfiguration

object (BigLakeConfiguration)

Opsional. Menentukan konfigurasi tabel BigQuery untuk Apache Iceberg.
managedTableType

enum (ManagedTableType)

Opsional. Jika disetel, akan menggantikan jenis tabel terkelola default yang dikonfigurasi dalam set data.
location

string

Hanya output. Lokasi geografis tempat tabel berada. Nilai ini diwarisi dari set data.
streamingBuffer

object (Streamingbuffer)

Hanya output. Berisi informasi terkait buffer streaming tabel ini, jika ada. Kolom ini tidak akan ada jika tabel tidak di-streaming ke atau jika tidak ada data dalam buffer streaming.
encryptionConfiguration

object (EncryptionConfiguration)

Konfigurasi enkripsi kustom (misalnya, Kunci Cloud KMS).
snapshotDefinition

object (SnapshotDefinition)

Hanya output. Berisi informasi tentang snapshot. Nilai ini ditetapkan melalui pembuatan snapshot.
defaultCollation

string

Opsional. Menentukan spesifikasi kolasi default kolom STRING baru dalam tabel. Selama pembuatan atau pembaruan tabel, jika kolom STRING ditambahkan ke tabel ini tanpa kolasi eksplisit yang ditentukan, tabel akan mewarisi kolasi default tabel. Perubahan pada kolom ini hanya memengaruhi kolom yang ditambahkan setelahnya, dan tidak mengubah kolom 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. Mendefinisikan spesifikasi mode pembulatan default untuk kolom desimal baru (NUMERIC ATAU BIGNUMERIC) dalam tabel. Selama pembuatan atau pembaruan tabel, jika kolom desimal ditambahkan ke tabel ini tanpa menentukan mode pembulatan eksplisit, kolom tersebut akan mewarisi mode pembulatan default tabel. Mengubah kolom ini tidak memengaruhi kolom yang ada.
cloneDefinition

object (CloneDefinition)

Hanya output. Berisi informasi tentang clone. Nilai ini ditetapkan melalui operasi clone.
numTimeTravelPhysicalBytes

string (Int64Value format)

Hanya output. Jumlah byte fisik yang digunakan oleh penyimpanan perjalanan waktu (data yang dihapus atau diubah). Data ini tidak disimpan secara real time, dan mungkin tertunda beberapa detik hingga beberapa menit.
numTotalLogicalBytes

string (Int64Value format)

Hanya output. Jumlah total byte logis dalam tabel atau tampilan terwujud.
numActiveLogicalBytes

string (Int64Value format)

Hanya output. Jumlah byte logis dengan usia kurang dari 90 hari.
numLongTermLogicalBytes

string (Int64Value format)

Hanya output. Jumlah byte logis dengan usia lebih dari 90 hari.
numCurrentPhysicalBytes

string (Int64Value format)

Hanya output. Jumlah byte fisik yang digunakan oleh penyimpanan data aktif saat ini. Data ini tidak disimpan secara real time, dan mungkin tertunda beberapa detik hingga beberapa menit.
numTotalPhysicalBytes

string (Int64Value format)

Hanya output. Ukuran fisik tabel ini dalam byte. Hal ini juga mencakup penyimpanan yang digunakan untuk perjalanan waktu. Data ini tidak disimpan secara real time, dan mungkin tertunda beberapa detik hingga beberapa menit.
numActivePhysicalBytes

string (Int64Value format)

Hanya output. Jumlah byte fisik dengan usia kurang dari 90 hari. Data ini tidak disimpan secara real time, dan mungkin tertunda beberapa detik hingga beberapa menit.
numLongTermPhysicalBytes

string (Int64Value format)

Hanya output. Jumlah byte fisik dengan usia lebih dari 90 hari. Data ini tidak disimpan secara real time, dan mungkin tertunda beberapa detik hingga beberapa menit.
numPartitions

string (Int64Value format)

Hanya output. Jumlah partisi yang ada dalam tabel atau tampilan terwujud. Data ini tidak disimpan secara real time, dan mungkin tertunda beberapa detik hingga beberapa menit.
maxStaleness

string

Opsional. Keusangan data maksimum yang dapat ditampilkan saat tabel (atau MV usang) dikueri. Keterlambatan yang dienkode sebagai encoding string dari jenis IntervalValue SQL.
restrictions

object (RestrictionConfig)

Opsional. Hanya output. Konfigurasi batasan untuk tabel. Jika disetel, batasi akses tertentu pada tabel berdasarkan konfigurasi. Lihat Egress data untuk mengetahui detail selengkapnya.
tableConstraints

object (TableConstraints)

Opsional. Informasi Kunci Utama dan Kunci Asing Tabel
resourceTags

map (key: string, value: string)

Opsional. Tag yang dilampirkan ke tabel 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" }.
tableReplicationInfo

object (TableReplicationInfo)

Opsional. Info replikasi tabel untuk tabel yang dibuat dengan DDL AS REPLICA seperti: CREATE MATERIALIZED VIEW mv1 AS REPLICA OF src_mv
replicas[]

object (TableReference)

Opsional. Hanya output. Referensi tabel dari semua replika yang saat ini aktif di tabel.
externalCatalogTableOptions

object (ExternalCatalogTableOptions)

Opsional. Opsi yang menentukan tabel yang kompatibel dengan open source.

Kolom union _partition_definition.

_partition_definition hanya dapat berupa salah satu dari hal berikut:
partitionDefinition

object (PartitioningDefinition)

Opsional. Informasi partisi untuk semua format tabel, termasuk tabel berpartisi terkelola, tabel berpartisi hive, tabel berpartisi iceberg, dan tabel berpartisi metastore. Kolom ini hanya diisi untuk tabel yang dipartisi metastore. Untuk format tabel lainnya, ini adalah kolom hanya output.
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 
{
  "value": string
}
Kolom
value

string

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

string
value

string
Representasi JSON 
{
  "fields": [
    {
      object (TableFieldSchema)
    }
  ],
  "foreignTypeInfo": {
    object (ForeignTypeInfo)
  }
}
Kolom
fields[]

object (TableFieldSchema)

Menjelaskan kolom dalam tabel.
foreignTypeInfo

object (ForeignTypeInfo)

Opsional. Menentukan metadata definisi jenis data asing dalam skema kolom (TableFieldSchema.foreign_type_definition).
Representasi JSON 
{
  "name": string,
  "type": string,
  "mode": string,
  "fields": [
    {
      object (TableFieldSchema)
    }
  ],
  "description": string,
  "policyTags": {
    object (PolicyTagList)
  },
  "dataPolicies": [
    {
      object (DataPolicyOption)
    }
  ],
  "nameAlternative": [
    string
  ],
  "maxLength": string,
  "precision": string,
  "scale": string,
  "timestampPrecision": string,
  "roundingMode": enum (RoundingMode),
  "collation": string,
  "defaultValueExpression": string,
  "rangeElementType": {
    object (FieldElementType)
  },
  "foreignTypeDefinition": string
}
Kolom
name

string

Wajib. Nama kolom. Nama hanya boleh berisi huruf (a-z, A-Z), angka (0-9), atau garis bawah (_), dan harus diawali dengan huruf atau garis bawah. Panjang maksimum adalah 300 karakter.
type

string

Wajib. Jenis data kolom. Nilai yang memungkinkan mencakup:

  • STRING
  • BYTES
  • INTEGER (atau INT64)
  • FLOAT (atau FLOAT64)
  • BOOLEAN (atau BOOL)
  • TIMESTAMP
  • DATE
  • WAKTU
  • DATETIME
  • GEOGRAPHY
  • NUMERIC
  • BIGNUMERIC
  • JSON
  • RECORD (atau STRUCT)
  • RANGE

Penggunaan RECORD/STRUCT menunjukkan bahwa kolom berisi skema bertingkat.
mode

string

Opsional. Mode kolom. Nilai yang mungkin mencakup NULLABLE, REQUIRED, dan REPEATED. Nilai defaultnya adalah NULLABLE.
fields[]

object (TableFieldSchema)

Opsional. Menjelaskan kolom skema bertingkat jika properti jenis ditetapkan ke RECORD.
description

string

Opsional. Deskripsi kolom. Panjang maksimumnya adalah 1.024 karakter.
policyTags

object (PolicyTagList)

Opsional. Tag kebijakan yang dilampirkan ke kolom ini, digunakan untuk kontrol akses tingkat kolom. Jika tidak disetel, default-nya adalah policy_tags kosong.
dataPolicies[]

object (DataPolicyOption)

Opsional. Kebijakan data yang dilampirkan ke kolom ini, digunakan untuk kontrol akses tingkat kolom.
nameAlternative[]

string

Kolom ini tidak boleh digunakan.
maxLength

string (int64 format)

Opsional. Panjang maksimum nilai kolom ini untuk STRING atau BYTE.

Jika max_length tidak ditentukan, tidak ada batasan panjang maksimum yang diterapkan pada kolom ini.

Jika type = "STRING", maka max_length mewakili panjang UTF-8 maksimum string di kolom ini.

Jika type = "BYTES", maka max_length mewakili jumlah maksimum byte dalam kolom ini.

Kolom ini tidak boleh ditetapkan jika type ≠ "STRING" dan ≠ "BYTES".
precision

string (int64 format)

Opsional. Batasan presisi (jumlah maksimum total digit dalam basis 10) dan skala (jumlah maksimum digit dalam bagian pecahan dalam basis 10) untuk nilai kolom ini untuk NUMERIC atau BIGNUMERIC.

Tidak valid untuk menyetel presisi atau skala jika type ≠ "NUMERIC" dan ≠ "BIGNUMERIC".

Jika presisi dan skala tidak ditentukan, tidak ada batasan rentang nilai yang diterapkan pada kolom ini selama nilai diizinkan oleh jenisnya.

Nilai kolom NUMERIC atau BIGNUMERIC ini harus berada dalam rentang ini jika:

  • Presisi (P) dan skala (S) ditentukan: [-10P-S + 10-S, 10P-S - 10-S]
  • Presisi (P) ditentukan, tetapi tidak dengan skala (sehingga skala ditafsirkan sama dengan nol): [-10P + 1, 10P - 1].

Nilai presisi dan skala yang dapat diterima jika keduanya ditentukan:

  • Jika type = "NUMERIC": 1 ≤ presisi - skala ≤ 29 dan 0 ≤ skala ≤ 9.
  • Jika type = "BIGNUMERIC": 1 ≤ presisi - skala ≤ 38 dan 0 ≤ skala ≤ 38.

Nilai presisi yang dapat diterima jika hanya presisi yang ditentukan, tetapi bukan skala (sehingga skala ditafsirkan sama dengan nol):

  • Jika type = "NUMERIC": 1 ≤ presisi ≤ 29.
  • Jika type = "BIGNUMERIC": 1 ≤ presisi ≤ 38.

Jika skala ditentukan tetapi tidak presisi, maka tidak valid.
scale

string (int64 format)

Opsional. Lihat dokumentasi untuk presisi.
timestampPrecision

string (Int64Value format)

Opsional. Presisi (jumlah maksimum total digit dalam basis 10) untuk detik jenis TIMESTAMP.

Nilai yang mungkin mencakup: * 6 (Default, untuk jenis TIMESTAMP dengan presisi mikrodetik) * 12 (Untuk jenis TIMESTAMP dengan presisi pikodetik)
roundingMode

enum (RoundingMode)

Opsional. Menentukan mode pembulatan yang akan digunakan saat menyimpan nilai jenis NUMERIC dan BIGNUMERIC.
collation

string

Opsional. Kolasi kolom hanya dapat ditetapkan jika jenis kolom adalah STRING. Nilai-nilai berikut didukung:

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

string

Opsional. Ekspresi SQL untuk menentukan nilai default untuk kolom ini.
rangeElementType

object (FieldElementType)

Opsional. Subjenis RANGE, jika jenis kolom ini adalah RANGE. Jika jenisnya adalah RANGE, kolom ini wajib diisi. Nilai untuk jenis elemen kolom dapat berupa berikut ini:

  • DATE
  • DATETIME
  • TIMESTAMP
foreignTypeDefinition

string

Opsional. Definisi jenis data asing. Hanya valid untuk kolom skema tingkat teratas (bukan kolom bertingkat). Jika jenisnya adalah ASING, kolom ini wajib diisi.
Representasi JSON 
{
  "names": [
    string
  ]
}
Kolom
names[]

string

Daftar nama resource tag kebijakan. Misalnya, "projects/1/locations/eu/taxonomies/2/policyTags/3". Saat ini hanya boleh ada maksimal 1 tag kebijakan.
Representasi JSON 
{

  // Union field _name can be only one of the following:
  "name": string
  // End of list of possible types for union field _name.
}
Kolom

Kolom union _name.

_name hanya dapat berupa salah satu dari hal berikut:
name

string

Nama resource kebijakan data dalam bentuk projects/project_id/locations/location_id/dataPolicies/data_policy_id.
Representasi JSON 
{
  "value": string
}
Kolom
value

string (int64 format)

Nilai int64.
Representasi JSON 
{
  "type": string
}
Kolom
type

string

Wajib. Jenis elemen kolom. Untuk informasi selengkapnya, lihat TableFieldSchema.type.
Representasi JSON 
{
  "typeSystem": enum (TypeSystem)
}
Kolom
typeSystem

enum (TypeSystem)

Wajib. Menentukan sistem yang menentukan jenis data asing.
Representasi JSON 
{
  "type": string,
  "expirationMs": string,
  "field": string,
  "requirePartitionFilter": boolean
}
Kolom
type

string

Wajib. Jenis yang didukung adalah DAY, HOUR, MONTH, dan YEAR, yang masing-masing akan menghasilkan satu partisi per hari, jam, bulan, dan tahun.
expirationMs

string (Int64Value format)

Opsional. Jumlah milidetik untuk menyimpan penyimpanan partisi. Wrapper digunakan di sini karena 0 adalah nilai yang tidak valid.
field

string

Opsional. Jika tidak ditetapkan, tabel dipartisi berdasarkan kolom semu '_PARTITIONTIME'; jika ditetapkan, tabel dipartisi berdasarkan kolom ini. Kolom harus berupa kolom TIMESTAMP atau DATE tingkat teratas. Modenya harus NULLABLE atau REQUIRED. Wrapper digunakan di sini karena string kosong adalah nilai yang tidak valid.
requirePartitionFilter
(deprecated)

boolean

Jika disetel ke benar (true), kueri atas tabel ini memerlukan filter partisi yang dapat digunakan untuk penghapusan partisi agar dapat ditentukan. Kolom ini tidak digunakan lagi; sebagai gantinya, tetapkan kolom dengan nama yang sama pada tabel itu sendiri. Kolom ini memerlukan wrapper karena kita ingin menghasilkan nilai default, salah (false), jika pengguna menyetelnya secara eksplisit.
Representasi JSON 
{
  "value": boolean
}
Kolom
value

boolean

Nilai bool.
Representasi JSON 
{
  "field": string,
  "range": {
    object (Range)
  }
}
Kolom
field

string

Wajib. Nama kolom untuk memartisi tabel. Kolom ini harus berupa kolom INT64 tingkat teratas yang modenya NULLABLE atau REQUIRED.
range

object (Range)

Menentukan rentang untuk partisi rentang.
Representasi JSON 
{
  "start": string,
  "end": string,
  "interval": string
}
Kolom
start

string

Wajib. Awal partisi rentang, inklusif. Kolom ini adalah nilai INT64 yang ditampilkan sebagai string.
end

string

Wajib. Akhir dari partisi rentang, eksklusif. Kolom ini adalah nilai INT64 yang ditampilkan sebagai string.
interval

string

Wajib. Lebar setiap interval. Kolom ini adalah nilai INT64 yang ditampilkan sebagai string.
Representasi JSON 
{
  "fields": [
    string
  ]
}
Kolom
fields[]

string

Satu atau beberapa kolom yang datanya harus dikelompokkan. Hanya kolom tingkat teratas, tidak berulang, dan jenis sederhana yang didukung. Pengurutan kolom pengelompokan harus diprioritaskan dari yang paling penting hingga yang paling tidak penting untuk tujuan pemfilteran.

Untuk informasi tambahan, lihat Pengantar tabel yang dikelompokkan.
Representasi JSON 
{
  "partitionedColumn": [
    {
      object (PartitionedColumn)
    }
  ]
}
Kolom
partitionedColumn[]

object (PartitionedColumn)

Opsional. Detail tentang setiap kolom partisi. Kolom ini hanya berupa output untuk semua jenis partisi selain tabel yang dipartisi metastore. Tabel native BigQuery hanya mendukung 1 kolom partisi. Jenis tabel lainnya dapat mendukung 0, 1, atau lebih banyak kolom partisi. Untuk tabel berpartisi metastore, urutannya harus sesuai dengan urutan definisi di Hive Metastore, yang harus sesuai dengan tata letak fisik tabel. Misalnya,

CREATE TABLE a_table(id BIGINT, name STRING) PARTITIONED BY (city STRING, state STRING).

Dalam hal ini, nilainya harus ['city', 'state'] dalam urutan tersebut.
Representasi JSON 
{

  // Union field _field can be only one of the following:
  "field": string
  // End of list of possible types for union field _field.
}
Kolom

Kolom union _field.

_field hanya dapat berupa salah satu dari hal berikut:
field

string

Wajib. Nama kolom partisi.
Representasi JSON 
{
  "value": string
}
Kolom
value

string

Nilai uint64.
Representasi JSON 
{
  "query": string,
  "userDefinedFunctionResources": [
    {
      object (UserDefinedFunctionResource)
    }
  ],
  "useLegacySql": boolean,
  "useExplicitColumnNames": boolean,
  "privacyPolicy": {
    object (PrivacyPolicy)
  },
  "foreignDefinitions": [
    {
      object (ForeignViewDefinition)
    }
  ]
}
Kolom
query

string

Wajib. Kueri yang dijalankan BigQuery saat tampilan dirujuk.
userDefinedFunctionResources[]

object (UserDefinedFunctionResource)

Menjelaskan resource fungsi yang ditentukan pengguna yang digunakan dalam kueri.
useLegacySql

boolean

Menentukan apakah akan menggunakan SQL lama BigQuery untuk tampilan ini. Nilai defaultnya adalah benar (true). Jika disetel ke salah (false), tampilan akan menggunakan GoogleSQL BigQuery: https://cloud.google.com/bigquery/sql-reference/

Kueri dan tampilan yang mereferensikan tampilan ini harus menggunakan nilai flag yang sama. Wrapper digunakan di sini karena nilai defaultnya adalah True.
useExplicitColumnNames

boolean

Benar jika nama kolom ditentukan secara eksplisit. Misalnya, dengan menggunakan sintaksis 'CREATE VIEW v(c1, c2) AS ...'. Hanya dapat ditetapkan untuk tampilan GoogleSQL.
privacyPolicy

object (PrivacyPolicy)

Opsional. Menentukan kebijakan privasi untuk tabel virtual.
foreignDefinitions[]

object (ForeignViewDefinition)

Opsional. Representasi tampilan asing.
Representasi JSON 
{
  "resourceUri": string,
  "inlineCode": string,
  "inlineCodeAlternative": [
    string
  ]
}
Kolom
resourceUri

string

[Pilih salah satu] Resource kode yang akan dimuat dari URI Google Cloud Storage (gs://bucket/path).
inlineCode

string

[Pilih salah satu] Resource inline yang berisi kode untuk fungsi yang ditentukan pengguna (UDF). Menyediakan resource kode inline setara dengan menyediakan URI untuk file yang berisi kode yang sama.
inlineCodeAlternative[]

string
Representasi JSON 
{

  // Union field privacy_policy can be only one of the following:
  "aggregationThresholdPolicy": {
    object (AggregationThresholdPolicy)
  },
  "differentialPrivacyPolicy": {
    object (DifferentialPrivacyPolicy)
  }
  // End of list of possible types for union field privacy_policy.

  // Union field _join_restriction_policy can be only one of the following:
  "joinRestrictionPolicy": {
    object (JoinRestrictionPolicy)
  }
  // End of list of possible types for union field _join_restriction_policy.
}
Kolom
Kolom union privacy_policy. Kebijakan privasi yang terkait dengan spesifikasi persyaratan ini. Hanya satu metode privasi yang diizinkan per objek sumber data. privacy_policy hanya ada berupa salah satu diantara berikut:
aggregationThresholdPolicy

object (AggregationThresholdPolicy)

Opsional. Kebijakan yang digunakan untuk nilai minimum agregasi.
differentialPrivacyPolicy

object (DifferentialPrivacyPolicy)

Opsional. Kebijakan yang digunakan untuk privasi diferensial.

Kolom union _join_restriction_policy.

_join_restriction_policy hanya dapat berupa salah satu dari hal berikut:
joinRestrictionPolicy

object (JoinRestrictionPolicy)

Opsional. Kebijakan pembatasan bergabung berada di luar salah satu kebijakan, karena kebijakan ini dapat ditetapkan bersama dengan kebijakan lainnya. Kebijakan ini memberi penyedia data kemampuan untuk menerapkan gabungan pada 'join_allowed_columns' saat data dikueri dari tampilan yang dilindungi privasi.
Representasi JSON 
{
  "privacyUnitColumns": [
    string
  ],

  // Union field _threshold can be only one of the following:
  "threshold": string
  // End of list of possible types for union field _threshold.
}
Kolom
privacyUnitColumns[]

string

Opsional. Kolom unit privasi yang terkait dengan kebijakan ini. Untuk saat ini, hanya satu kolom per objek sumber data (tabel, tampilan) yang diizinkan sebagai kolom unit privasi. Direpresentasikan sebagai kolom berulang dalam metadata untuk kemampuan ekstensi ke beberapa kolom pada masa mendatang. Kolom struct Duplikat dan Berulang tidak diizinkan. Untuk kolom bertingkat, gunakan notasi titik ("outer.inner")

Kolom union _threshold.

_threshold hanya dapat berupa salah satu dari hal berikut:
threshold

string (int64 format)

Opsional. Nilai minimum untuk kebijakan "nilai minimum agregasi".
Representasi JSON 
{

  // Union field _max_epsilon_per_query can be only one of the following:
  "maxEpsilonPerQuery": number
  // End of list of possible types for union field _max_epsilon_per_query.

  // Union field _delta_per_query can be only one of the following:
  "deltaPerQuery": number
  // End of list of possible types for union field _delta_per_query.

  // Union field _max_groups_contributed can be only one of the following:
  "maxGroupsContributed": string
  // End of list of possible types for union field _max_groups_contributed.

  // Union field _privacy_unit_column can be only one of the following:
  "privacyUnitColumn": string
  // End of list of possible types for union field _privacy_unit_column.

  // Union field _epsilon_budget can be only one of the following:
  "epsilonBudget": number
  // End of list of possible types for union field _epsilon_budget.

  // Union field _delta_budget can be only one of the following:
  "deltaBudget": number
  // End of list of possible types for union field _delta_budget.

  // Union field _epsilon_budget_remaining can be only one of the following:
  "epsilonBudgetRemaining": number
  // End of list of possible types for union field _epsilon_budget_remaining.

  // Union field _delta_budget_remaining can be only one of the following:
  "deltaBudgetRemaining": number
  // End of list of possible types for union field _delta_budget_remaining.
}
Kolom

Kolom union _max_epsilon_per_query.

_max_epsilon_per_query hanya dapat berupa salah satu dari hal berikut:
maxEpsilonPerQuery

number

Opsional. Nilai epsilon maksimum yang dapat digunakan kueri. Jika pelanggan menentukan epsilon sebagai parameter dalam kueri SELECT, epsilon harus kurang dari atau sama dengan nilai ini. Parameter epsilon mengontrol jumlah derau yang ditambahkan ke grup — epsilon yang lebih tinggi berarti lebih sedikit derau.

Kolom union _delta_per_query.

_delta_per_query hanya dapat berupa salah satu dari hal berikut:
deltaPerQuery

number

Opsional. Nilai delta yang digunakan per kueri. Delta mewakili probabilitas bahwa setiap baris akan gagal menjadi privasi diferensial epsilon. Menunjukkan risiko yang terkait dengan mengekspos baris gabungan dalam hasil kueri.

Kolom union _max_groups_contributed.

_max_groups_contributed hanya dapat berupa salah satu dari hal berikut:
maxGroupsContributed

string (int64 format)

Opsional. Nilai kontribusi grup maksimum yang digunakan per kueri. Mewakili jumlah maksimum grup yang dapat diikuti oleh setiap entitas yang dilindungi. Mengubah nilai ini tidak meningkatkan atau menurunkan privasi. Nilai terbaik untuk akurasi dan kegunaan bergantung pada kueri dan data.

Kolom union _privacy_unit_column.

_privacy_unit_column hanya dapat berupa salah satu dari hal berikut:
privacyUnitColumn

string

Opsional. Kolom unit privasi yang terkait dengan kebijakan ini. Kebijakan privasi diferensial hanya dapat memiliki satu kolom unit privasi per objek sumber data (tabel, tampilan).

Kolom union _epsilon_budget.

_epsilon_budget hanya dapat berupa salah satu dari hal berikut:
epsilonBudget

number

Opsional. Total anggaran epsilon untuk semua kueri terhadap tampilan yang dilindungi privasi. Setiap kueri pelanggan terhadap tampilan ini akan dikenai biaya epsilon yang diminta dalam kueri mereka. Jika ada anggaran yang cukup, kueri pelanggan akan mencoba diselesaikan. Transaksi mungkin masih gagal karena alasan lain, dan dalam hal ini, tagihan akan dikembalikan dananya. Jika anggaran tidak mencukupi, kueri akan ditolak. Mungkin ada beberapa upaya penagihan jika satu kueri mereferensikan beberapa tampilan. Dalam hal ini, harus ada anggaran yang cukup untuk semua biaya atau kueri ditolak dan biaya dikembalikan dengan upaya terbaik. Anggaran tidak memiliki kebijakan pembaruan dan hanya dapat diupdate melalui ALTER VIEW atau diatasi dengan membuat tampilan baru yang dapat dikueri dengan anggaran baru.

Kolom union _delta_budget.

_delta_budget hanya dapat berupa salah satu dari hal berikut:
deltaBudget

number

Opsional. Total anggaran delta untuk semua kueri terhadap tampilan yang dilindungi privasi. Setiap kueri pelanggan terhadap tampilan ini mengenakan biaya sebesar delta yang telah ditentukan sebelumnya oleh kontributor melalui kolom delta_per_query kebijakan privasi. Jika ada anggaran yang cukup, kueri pelanggan akan mencoba diselesaikan. Transaksi mungkin masih gagal karena alasan lain, dan dalam hal ini, tagihan akan dikembalikan dananya. Jika anggaran tidak mencukupi, kueri akan ditolak. Mungkin ada beberapa upaya penagihan jika satu kueri mereferensikan beberapa tampilan. Dalam hal ini, harus ada anggaran yang cukup untuk semua biaya atau kueri ditolak dan biaya dikembalikan dengan upaya terbaik. Anggaran tidak memiliki kebijakan pembaruan dan hanya dapat diupdate melalui ALTER VIEW atau diatasi dengan membuat tampilan baru yang dapat dikueri dengan anggaran baru.

Kolom union _epsilon_budget_remaining.

_epsilon_budget_remaining hanya dapat berupa salah satu dari hal berikut:
epsilonBudgetRemaining

number

Hanya output. Sisa anggaran epsilon. Jika anggaran habis, tidak ada lagi kueri yang diizinkan. Perhatikan bahwa anggaran untuk kueri yang sedang berlangsung akan dikurangi sebelum kueri dijalankan. Jika kueri gagal atau dibatalkan, anggaran akan dikembalikan. Dalam hal ini, jumlah anggaran yang tersisa dapat meningkat.

Kolom union _delta_budget_remaining.

_delta_budget_remaining hanya dapat berupa salah satu dari hal berikut:
deltaBudgetRemaining

number

Hanya output. Sisa anggaran delta. Jika anggaran habis, tidak ada lagi kueri yang diizinkan. Perhatikan bahwa anggaran untuk kueri yang sedang berlangsung akan dikurangi sebelum kueri dijalankan. Jika kueri gagal atau dibatalkan, anggaran akan dikembalikan. Dalam hal ini, jumlah anggaran yang tersisa dapat meningkat.
Representasi JSON 
{
  "joinAllowedColumns": [
    string
  ],

  // Union field _join_condition can be only one of the following:
  "joinCondition": enum (JoinCondition)
  // End of list of possible types for union field _join_condition.
}
Kolom
joinAllowedColumns[]

string

Opsional. Hanya kolom yang dapat digabungkan yang diizinkan. Kolom ini harus ditentukan untuk join_conditions JOIN_ANY dan JOIN_ALL, serta tidak dapat ditetapkan untuk JOIN_BLOCKED.

Kolom union _join_condition.

_join_condition hanya dapat berupa salah satu dari hal berikut:
joinCondition

enum (JoinCondition)

Opsional. Menentukan apakah gabungan diperlukan atau tidak pada kueri untuk tampilan. Default-nya adalah JOIN_CONDITION_UNSPECIFIED.
Representasi JSON 
{
  "query": string,
  "dialect": string
}
Kolom
query

string

Wajib. Kueri yang menentukan tampilan.
dialect

string

Opsional. Mewakili dialek kueri.
Representasi JSON 
{
  "query": string,
  "lastRefreshTime": string,
  "enableRefresh": boolean,
  "refreshIntervalMs": string,
  "allowNonIncrementalDefinition": boolean
}
Kolom
query

string

Wajib. Kueri yang hasilnya dipertahankan.
lastRefreshTime

string (int64 format)

Hanya output. Waktu saat tampilan terwujud ini terakhir dimuat ulang, dalam milidetik sejak epoch.
enableRefresh

boolean

Opsional. Aktifkan muat ulang otomatis tampilan terwujud saat tabel dasar diperbarui. Nilai defaultnya adalah "true".
refreshIntervalMs

string (UInt64Value format)

Opsional. Frekuensi maksimum tampilan terwujud ini akan dimuat ulang. Nilai defaultnya adalah "1800000" (30 menit).
allowNonIncrementalDefinition

boolean

Opsional. Opsi ini menyatakan niat untuk membuat tampilan terwujud yang tidak diperbarui secara bertahap. Tampilan terwujud non-inkremental mendukung rentang kueri SQL yang diperluas. Opsi allow_non_incremental_definition tidak dapat diubah setelah tampilan terwujud dibuat.
Representasi JSON 
{
  "refreshWatermark": string,
  "lastRefreshStatus": {
    object (ErrorProto)
  }
}
Kolom
refreshWatermark

string (Timestamp format)

Hanya output. Watermark pemuatan ulang tampilan terwujud. Data tabel dasar dikumpulkan ke dalam cache tampilan terwujud hingga saat ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
lastRefreshStatus

object (ErrorProto)

Hanya output. Hasil error dari pemuatan ulang otomatis terakhir. Jika ada, menunjukkan bahwa pemuatan ulang otomatis terakhir gagal.
Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.
Representasi JSON 
{
  "reason": string,
  "location": string,
  "debugInfo": string,
  "message": string
}
Kolom
reason

string

Kode error singkat yang merangkum error.
location

string

Menentukan tempat terjadinya error, jika ada.
debugInfo

string

Informasi proses debug. Properti ini bersifat internal untuk Google dan tidak boleh digunakan.
message

string

Deskripsi error yang dapat dibaca manusia.
Representasi JSON 
{
  "sourceUris": [
    string
  ],
  "fileSetSpecType": enum (FileSetSpecType),
  "schema": {
    object (TableSchema)
  },
  "sourceFormat": string,
  "maxBadRecords": integer,
  "autodetect": boolean,
  "ignoreUnknownValues": boolean,
  "compression": string,
  "csvOptions": {
    object (CsvOptions)
  },
  "jsonOptions": {
    object (JsonOptions)
  },
  "bigtableOptions": {
    object (BigtableOptions)
  },
  "googleSheetsOptions": {
    object (GoogleSheetsOptions)
  },
  "maxBadRecordsAlternative": [
    integer
  ],
  "hivePartitioningOptions": {
    object (HivePartitioningOptions)
  },
  "connectionId": string,
  "decimalTargetTypes": [
    enum (DecimalTargetType)
  ],
  "avroOptions": {
    object (AvroOptions)
  },
  "jsonExtension": enum (JsonExtension),
  "parquetOptions": {
    object (ParquetOptions)
  },
  "referenceFileSchemaUri": string,
  "metadataCacheMode": enum (MetadataCacheMode),
  "timestampTargetPrecision": [
    integer
  ],

  // Union field _object_metadata can be only one of the following:
  "objectMetadata": enum (ObjectMetadata)
  // End of list of possible types for union field _object_metadata.

  // Union field _time_zone can be only one of the following:
  "timeZone": string
  // End of list of possible types for union field _time_zone.

  // Union field _date_format can be only one of the following:
  "dateFormat": string
  // End of list of possible types for union field _date_format.

  // Union field _datetime_format can be only one of the following:
  "datetimeFormat": string
  // End of list of possible types for union field _datetime_format.

  // Union field _time_format can be only one of the following:
  "timeFormat": string
  // End of list of possible types for union field _time_format.

  // Union field _timestamp_format can be only one of the following:
  "timestampFormat": string
  // End of list of possible types for union field _timestamp_format.
}
Kolom
sourceUris[]

string

[Wajib] URI yang sepenuhnya memenuhi syarat yang mengarah ke data Anda di Google Cloud. Untuk URI Google Cloud Storage: Setiap URI dapat berisi satu karakter pengganti '*' dan harus muncul setelah nama 'bucket'. Batas ukuran terkait tugas pemuatan berlaku untuk sumber data eksternal. Untuk URI Google Cloud Bigtable: Hanya satu URI yang dapat ditentukan dan harus berupa URL HTTPS yang sepenuhnya ditentukan dan valid untuk tabel Google Cloud Bigtable. Untuk cadangan Google Cloud Datastore, tepat satu URI yang dapat ditentukan. Selain itu, karakter pengganti '*' tidak diizinkan.
fileSetSpecType

enum (FileSetSpecType)

Opsional. Menentukan cara menafsirkan URI sumber untuk membuat set file yang akan dimuat. Secara default, URI sumber diperluas terhadap penyimpanan yang mendasarinya. Opsi lainnya mencakup penentuan file manifes. Hanya berlaku untuk sistem penyimpanan objek.
schema

object (TableSchema)

Opsional. Skema untuk data. Skema diperlukan untuk format CSV dan JSON jika deteksi otomatis tidak diaktifkan. Skema tidak diizinkan untuk Google Cloud Bigtable, cadangan Cloud Datastore, format Avro, ORC, dan Parquet.
sourceFormat

string

[Wajib] Format data. Untuk file CSV, tentukan "CSV". Untuk Google Spreadsheet, tentukan "GOOGLE_SHEETS". Untuk JSON yang dibatasi baris baru, tentukan "NEWLINE_DELIMITED_JSON". Untuk file Avro, tentukan "AVRO". Untuk pencadangan Google Cloud Datastore, tentukan "DATASTORE_BACKUP". Untuk tabel Apache Iceberg, tentukan "ICEBERG". Untuk file ORC, tentukan "ORC". Untuk file Parquet, tentukan "PARQUET". [Beta] Untuk Google Cloud Bigtable, tentukan "BIGTABLE".
maxBadRecords

integer

Opsional. Jumlah maksimum data buruk yang dapat diabaikan BigQuery saat membaca data. Jika jumlah catatan buruk melebihi nilai ini, error yang tidak valid akan ditampilkan di hasil tugas. Nilai defaultnya adalah 0, yang mengharuskan semua kumpulan data valid. Setelan ini diabaikan untuk Google Cloud Bigtable, cadangan Google Cloud Datastore, format Avro, ORC, dan Parquet.
autodetect

boolean

Mencoba mendeteksi opsi skema dan format secara otomatis. Setiap opsi yang ditentukan secara eksplisit akan dipatuhi.
ignoreUnknownValues

boolean

Opsional. Menunjukkan apakah BigQuery harus mengizinkan nilai tambahan yang tidak direpresentasikan dalam skema tabel. Jika benar, nilai tambahan akan diabaikan. Jika false, kumpulan data dengan kolom tambahan akan dianggap sebagai kumpulan data buruk, dan jika ada terlalu banyak kumpulan data buruk, error yang tidak valid akan ditampilkan dalam hasil tugas. Nilai defaultnya adalah false. Properti sourceFormat menentukan apa yang diperlakukan BigQuery sebagai nilai tambahan: CSV: Kolom akhir JSON: Nilai bernama yang tidak cocok dengan nama kolom mana pun Google Cloud Bigtable: Setelan ini diabaikan. Cadangan Google Cloud Datastore: Setelan ini diabaikan. Avro: Setelan ini diabaikan. ORC: Setelan ini diabaikan. Parquet: Setelan ini diabaikan.
compression

string

Opsional. Jenis kompresi sumber data. Nilai yang mungkin mencakup GZIP dan NONE. Nilai defaultnya adalah NONE. Setelan ini diabaikan untuk Google Cloud Bigtable, cadangan Google Cloud Datastore, format Avro, ORC, dan Parquet. String kosong adalah nilai yang tidak valid.
csvOptions

object (CsvOptions)

Opsional. Properti tambahan yang akan ditetapkan jika sourceFormat ditetapkan ke CSV.
jsonOptions

object (JsonOptions)

Opsional. Properti tambahan yang akan ditetapkan jika sourceFormat ditetapkan ke JSON.
bigtableOptions

object (BigtableOptions)

Opsional. Opsi tambahan jika sourceFormat disetel ke BIGTABLE.
googleSheetsOptions

object (GoogleSheetsOptions)

Opsional. Opsi tambahan jika sourceFormat ditetapkan ke GOOGLE_SHEETS.
maxBadRecordsAlternative[]

integer

Kolom ini tidak boleh digunakan.
hivePartitioningOptions

object (HivePartitioningOptions)

Opsional. Jika disetel, mengonfigurasi dukungan partisi Hive. Tidak semua format penyimpanan mendukung partisi Hive. Meminta partisi Hive pada format yang tidak didukung akan menyebabkan error, begitu juga dengan memberikan spesifikasi yang tidak valid.
connectionId

string

Opsional. Koneksi yang menentukan kredensial yang akan digunakan untuk membaca penyimpanan eksternal, seperti Azure Blob, Cloud Storage, atau S3. connection_id dapat memiliki bentuk {project_id}.{location_id};{connection_id} atau projects/{project_id}/locations/{location_id}/connections/{connection_id}.
decimalTargetTypes[]

enum (DecimalTargetType)

Menentukan daftar kemungkinan jenis data SQL yang dapat dikonversi dari nilai desimal sumber. Daftar ini serta parameter presisi dan skala kolom desimal menentukan jenis target. Dalam urutan NUMERIC, BIGNUMERIC, dan STRING, jenis akan dipilih jika ada dalam daftar yang ditentukan dan jika mendukung presisi dan skala. STRING mendukung semua nilai presisi dan skala. Jika tidak satu pun jenis yang tercantum mendukung presisi dan skala, jenis yang mendukung rentang terluas dalam daftar yang ditentukan akan dipilih, dan jika nilai melebihi rentang yang didukung saat membaca data, error akan ditampilkan.

Contoh: Anggap nilai kolom ini adalah ["NUMERIC", "BIGNUMERIC"]. Jika (presisi,skala) adalah:

  • (38,9) -> NUMERIK;
  • (39,9) -> BIGNUMERIC (NUMERIC tidak dapat menyimpan 30 digit bilangan bulat);
  • (38,10) -> BIGNUMERIC (NUMERIC tidak dapat menyimpan 10 digit pecahan);
  • (76,38) -> BIGNUMERIC;
  • (77,38) -> BIGNUMERIC (error jika nilai melebihi rentang yang didukung).

Kolom ini tidak boleh berisi jenis duplikat. Urutan jenis dalam kolom ini diabaikan. Misalnya, ["BIGNUMERIC", "NUMERIC"] sama dengan ["NUMERIC", "BIGNUMERIC"] dan NUMERIC selalu lebih diutamakan daripada BIGNUMERIC.

Secara default ditetapkan ke ["NUMERIC", "STRING"] untuk ORC dan ["NUMERIC"] untuk format file lainnya.
avroOptions

object (AvroOptions)

Opsional. Properti tambahan yang akan ditetapkan jika sourceFormat ditetapkan ke AVRO.
jsonExtension

enum (JsonExtension)

Opsional. Opsi pemuatan yang akan digunakan bersama dengan JSON yang dipisahkan newline source_format untuk menunjukkan bahwa varian JSON sedang dimuat. Untuk memuat GeoJSON yang dibatasi newline, tentukan GEOJSON (dan source_format harus ditetapkan ke NEWLINE_DELIMITED_JSON).
parquetOptions

object (ParquetOptions)

Opsional. Properti tambahan yang akan ditetapkan jika sourceFormat ditetapkan ke PARQUET.
referenceFileSchemaUri

string

Opsional. Saat membuat tabel eksternal, pengguna dapat memberikan file referensi dengan skema tabel. Fitur ini diaktifkan untuk format berikut: AVRO, PARQUET, ORC.
metadataCacheMode

enum (MetadataCacheMode)

Opsional. Mode Cache Metadata untuk tabel. Tetapkan ini untuk mengaktifkan penyimpanan dalam cache metadata dari sumber data eksternal.
timestampTargetPrecision[]

integer

Presisi (jumlah maksimum total digit dalam basis 10) untuk detik jenis TIMESTAMP yang diizinkan ke tabel tujuan untuk mode deteksi otomatis.

Tersedia untuk format: CSV.

Untuk Format CSV, Nilai yang mungkin mencakup: Tidak Ditentukan, [], atau [6]: timestamp(6) untuk semua kolom TIMESTAMP yang terdeteksi otomatis [6, 12]: timestamp(6) untuk semua kolom TIMESTAMP yang terdeteksi otomatis yang memiliki subdetik kurang dari 6 digit. timestamp(12) untuk semua kolom TIMESTAMP yang terdeteksi otomatis yang memiliki lebih dari 6 digit subdetik. [12]: timestamp(12) untuk semua kolom TIMESTAMP yang terdeteksi otomatis.

Urutan elemen dalam array ini diabaikan. Input yang memiliki presisi lebih tinggi daripada presisi target tertinggi dalam array ini akan dipangkas.

Kolom union _object_metadata.

_object_metadata hanya dapat berupa salah satu dari hal berikut:
objectMetadata

enum (ObjectMetadata)

Opsional. ObjectMetadata digunakan untuk membuat Tabel Objek. Tabel Objek berisi daftar objek (dengan metadatanya) yang ditemukan di source_uris. Jika ObjectMetadata ditetapkan, source_format harus dihilangkan.

Saat ini, SIMPLE adalah satu-satunya jenis Metadata Objek yang didukung.

Kolom union _time_zone.

_time_zone hanya dapat berupa salah satu dari hal berikut:
timeZone

string

Opsional. Zona waktu yang digunakan saat mengurai nilai stempel waktu yang tidak memiliki informasi zona waktu tertentu (misalnya, 2024-04-20 12:34:56). Format yang diharapkan adalah string zona waktu IANA (misalnya, America/Los_Angeles).

Kolom union _date_format.

_date_format hanya dapat berupa salah satu dari hal berikut:
dateFormat

string

Opsional. Format yang digunakan untuk mengurai nilai DATE. Mendukung nilai gaya C dan gaya SQL.

Kolom union _datetime_format.

_datetime_format hanya dapat berupa salah satu dari hal berikut:
datetimeFormat

string

Opsional. Format yang digunakan untuk mengurai nilai DATETIME. Mendukung nilai gaya C dan gaya SQL.

Kolom union _time_format.

_time_format hanya dapat berupa salah satu dari hal berikut:
timeFormat

string

Opsional. Format yang digunakan untuk mengurai nilai TIME. Mendukung nilai gaya C dan gaya SQL.

Kolom union _timestamp_format.

_timestamp_format hanya dapat berupa salah satu dari hal berikut:
timestampFormat

string

Opsional. Format yang digunakan untuk mengurai nilai TIMESTAMP. Mendukung nilai gaya C dan gaya SQL.
Representasi JSON 
{
  "value": integer
}
Kolom
value

integer

Nilai int32.
Representasi JSON 
{
  "fieldDelimiter": string,
  "skipLeadingRows": string,
  "quote": string,
  "allowQuotedNewlines": boolean,
  "allowJaggedRows": boolean,
  "encoding": string,
  "preserveAsciiControlCharacters": boolean,
  "nullMarker": string,
  "nullMarkers": [
    string
  ],
  "sourceColumnMatch": string
}
Kolom
fieldDelimiter

string

Opsional. Karakter pemisah untuk kolom dalam file CSV. Pemisah ditafsirkan sebagai satu byte. Untuk file yang dienkode dalam ISO-8859-1, karakter tunggal apa pun dapat digunakan sebagai pemisah. Untuk file yang dienkode dalam UTF-8, karakter yang ditampilkan dalam rentang desimal 1-127 (U+0001-U+007F) dapat digunakan tanpa modifikasi apa pun. Karakter UTF-8 yang dienkode dengan beberapa byte (yaitu U+0080 dan yang lebih tinggi) hanya akan menggunakan byte pertama untuk memisahkan kolom. Byte yang tersisa akan diperlakukan sebagai bagian dari kolom. BigQuery juga mendukung urutan escape "\t" (U+0009) untuk menentukan pemisah tab. Nilai defaultnya adalah koma (",", U+002C).
skipLeadingRows

string (Int64Value format)

Opsional. Jumlah baris di bagian atas file CSV yang akan dilewati BigQuery saat membaca data. Nilai defaultnya adalah 0. Properti ini berguna jika Anda memiliki baris header dalam file yang harus dilewati. Jika deteksi otomatis aktif, perilakunya adalah sebagai berikut:

  • skipLeadingRows tidak ditentukan - Deteksi otomatis mencoba mendeteksi header di baris pertama. Jika tidak terdeteksi, baris akan dibaca sebagai data. Jika tidak, data dibaca mulai dari baris kedua.
  • skipLeadingRows adalah 0 - Menginstruksikan deteksi otomatis bahwa tidak ada header dan data harus dibaca mulai dari baris pertama.
  • skipLeadingRows = N > 0 - Mendeteksi otomatis akan melewati N-1 baris dan mencoba mendeteksi header di baris N. Jika header tidak terdeteksi, baris N akan dilewati. Jika tidak, baris N digunakan untuk mengekstrak nama kolom untuk skema yang terdeteksi.
quote

string

Opsional. Nilai yang digunakan untuk mengutip bagian data dalam file CSV. BigQuery mengonversi string menjadi encoding ISO-8859-1, lalu menggunakan byte pertama dari string yang dienkode untuk membagi data dalam status biner mentahnya. Nilai defaultnya adalah tanda kutip ganda ("). Jika data Anda tidak berisi bagian yang dikutip, tetapkan nilai properti menjadi string kosong. Jika data Anda berisi karakter baris baru yang dikutip, Anda juga harus menyetel properti allowQuotedNewlines ke benar. Untuk menyertakan karakter tanda kutip tertentu dalam nilai yang dikutip, awali dengan karakter tanda kutip tambahan yang cocok. Misalnya, jika Anda ingin meng-escape karakter default ' " ', gunakan ' "" '.
allowQuotedNewlines

boolean

Opsional. Menunjukkan apakah BigQuery harus mengizinkan bagian data yang dikutip yang berisi karakter baris baru dalam file CSV. Nilai defaultnya adalah false.
allowJaggedRows

boolean

Opsional. Menunjukkan apakah BigQuery harus menerima baris yang tidak memiliki kolom opsional di akhir. Jika benar, BigQuery memperlakukan kolom akhir yang tidak ada sebagai nilai null. Jika salah, kumpulan data yang tidak memiliki kolom di akhir akan dianggap sebagai kumpulan data buruk, dan jika ada terlalu banyak kumpulan data buruk, error tidak valid akan ditampilkan dalam hasil tugas. Nilai defaultnya adalah false.
encoding

string

Opsional. Encoding karakter data. Nilai yang didukung adalah UTF-8, ISO-8859-1, UTF-16BE, UTF-16LE, UTF-32BE, dan UTF-32LE. Nilai defaultnya adalah UTF-8. BigQuery mendekode data setelah data biner mentah dibagi menggunakan nilai properti kutipan dan fieldDelimiter.
preserveAsciiControlCharacters

boolean

Opsional. Menunjukkan apakah karakter kontrol ASCII tersemat (32 karakter pertama dalam tabel ASCII, dari '\x00' hingga '\x1F') dipertahankan.
nullMarker

string

Opsional. Menentukan string yang mewakili nilai null dalam file CSV. Misalnya, jika Anda menentukan "\N", BigQuery akan menafsirkan "\N" sebagai nilai null saat membuat kueri file CSV. Nilai defaultnya adalah string kosong. Jika Anda menetapkan properti ini ke nilai khusus, BigQuery akan menampilkan error jika string kosong ada untuk semua jenis data, kecuali untuk STRING dan BYTE. Untuk kolom STRING dan BYTE, BigQuery menafsirkan string kosong sebagai nilai kosong.
nullMarkers[]

string

Opsional. Daftar string yang ditampilkan sebagai nilai NULL SQL dalam file CSV.

null_marker dan null_markers tidak dapat ditetapkan secara bersamaan. Jika null_marker ditetapkan, null_markers tidak boleh ditetapkan. Jika null_markers ditetapkan, null_marker tidak boleh ditetapkan. Jika null_marker dan null_markers disetel secara bersamaan, error pengguna akan ditampilkan. Semua string yang tercantum di null_markers, termasuk string kosong, akan ditafsirkan sebagai SQL NULL. Hal ini berlaku untuk semua jenis kolom.
sourceColumnMatch

string

Opsional. Mengontrol strategi yang digunakan untuk mencocokkan kolom yang dimuat dengan skema. Jika tidak ditetapkan, setelan default yang wajar akan dipilih berdasarkan cara skema diberikan. Jika deteksi otomatis digunakan, kolom akan dicocokkan berdasarkan nama. Jika tidak, kolom dicocokkan berdasarkan posisi. Hal ini dilakukan untuk menjaga perilaku agar kompatibel dengan versi sebelumnya. Nilai yang dapat diterima adalah: POSISI - cocok berdasarkan posisi. Hal ini mengasumsikan bahwa kolom diurutkan dengan cara yang sama seperti skema. NAMA - mencocokkan menurut nama. Tindakan ini membaca baris header sebagai nama kolom dan menyusun ulang kolom agar cocok dengan nama kolom dalam skema.
Representasi JSON 
{
  "encoding": string
}
Kolom
encoding

string

Opsional. Encoding karakter data. Nilai yang didukung adalah UTF-8, UTF-16BE, UTF-16LE, UTF-32BE, dan UTF-32LE. Nilai defaultnya adalah UTF-8.
Representasi JSON 
{
  "columnFamilies": [
    {
      object (BigtableColumnFamily)
    }
  ],
  "ignoreUnspecifiedColumnFamilies": boolean,
  "readRowkeyAsString": boolean,
  "outputColumnFamiliesAsJson": boolean
}
Kolom
columnFamilies[]

object (BigtableColumnFamily)

Opsional. Daftar grup kolom yang akan ditampilkan dalam skema tabel beserta jenisnya. Daftar ini membatasi kolom keluarga yang dapat dirujuk dalam kueri dan menentukan jenis nilainya. Anda dapat menggunakan daftar ini untuk melakukan konversi jenis - lihat kolom 'type' untuk mengetahui detail selengkapnya. Jika Anda membiarkan daftar ini kosong, semua grup kolom akan ada dalam skema tabel dan nilainya dibaca sebagai BYTES. Selama kueri, hanya grup kolom yang direferensikan dalam kueri tersebut yang dibaca dari Bigtable.
ignoreUnspecifiedColumnFamilies

boolean

Opsional. Jika kolom bernilai benar (true), grup kolom yang tidak ditentukan dalam daftar columnFamilies tidak akan diekspos dalam skema tabel. Jika tidak, grup kolom tersebut akan dibaca dengan nilai jenis BYTES. Nilai defaultnya adalah false.
readRowkeyAsString

boolean

Opsional. Jika kolom bernilai benar (true), grup kolom row key akan dibaca dan dikonversi menjadi string. Jika tidak, grup kolom tersebut akan dibaca dengan nilai jenis BYTES dan pengguna harus melakukan transmisi secara manual dengan CAST jika perlu. Nilai defaultnya adalah false.
outputColumnFamiliesAsJson

boolean

Opsional. Jika kolom benar, setiap family kolom akan dibaca sebagai satu kolom JSON. Jika tidak, kolom tersebut akan dibaca sebagai struktur sel berulang yang berisi tuple stempel waktu/nilai. Nilai defaultnya adalah false.
Representasi JSON 
{
  "familyId": string,
  "type": string,
  "encoding": string,
  "columns": [
    {
      object (BigtableColumn)
    }
  ],
  "onlyReadLatest": boolean,
  "protoConfig": {
    object (BigtableProtoConfig)
  }
}
Kolom
familyId

string

ID grup kolom.
type

string

Opsional. Jenis untuk mengonversi nilai dalam sel grup kolom ini. Nilai diharapkan dienkode menggunakan fungsi Bytes.toBytes HBase saat menggunakan nilai encoding BINARY. Jenis BigQuery berikut diizinkan (peka huruf besar/kecil):

  • BYTES
  • STRING
  • INTEGER
  • FLOAT
  • BOOLEAN
  • JSON

Jenis defaultnya adalah BYTES. Setelan ini dapat diganti untuk kolom tertentu dengan mencantumkan kolom tersebut di 'columns' dan menentukan jenisnya.
encoding

string

Opsional. Encoding nilai saat jenisnya bukan STRING. Nilai encoding yang dapat diterima adalah: TEXT - menunjukkan bahwa nilai adalah string teks alfanumerik. BINARY - menunjukkan bahwa nilai dienkode menggunakan fungsi keluarga Bytes.toBytes HBase. PROTO_BINARY - menunjukkan bahwa nilai dienkode menggunakan pesan proto yang diserialisasi. Ini hanya dapat digunakan bersama dengan jenis JSON. Setelan ini dapat diganti untuk kolom tertentu dengan mencantumkan kolom tersebut di 'columns' dan menentukan encoding untuknya.
columns[]

object (BigtableColumn)

Opsional. Daftar kolom yang harus ditampilkan sebagai kolom individual, bukan sebagai daftar pasangan (nama kolom, nilai). Semua kolom yang kualifikasinya cocok dengan kualifikasi dalam daftar ini dapat diakses sebagai <family field name>.<column field name>. Kolom lain dapat diakses sebagai daftar melalui kolom <family field name>.Column.
onlyReadLatest

boolean

Opsional. Jika opsi ini disetel, hanya nilai versi terbaru yang diekspos untuk semua kolom dalam grup kolom ini. Setelan ini dapat diganti untuk kolom tertentu dengan mencantumkan kolom tersebut di 'columns' dan menentukan setelan yang berbeda untuk kolom tersebut.
protoConfig

object (BigtableProtoConfig)

Opsional. Konfigurasi khusus Protobuf, hanya berlaku jika encodingnya adalah PROTO_BINARY.
Representasi JSON 
{
  "qualifierEncoded": string,
  "qualifierString": string,
  "fieldName": string,
  "type": string,
  "encoding": string,
  "onlyReadLatest": boolean,
  "protoConfig": {
    object (BigtableProtoConfig)
  }
}
Kolom
qualifierEncoded

string (BytesValue format)

[Wajib] Penentu kolom. Kolom dalam grup kolom induk yang memiliki penentu persis ini ditampilkan sebagai kolom <family field name>.<column field name>. Jika penentu adalah string UTF-8 yang valid, penentu dapat ditentukan di kolom qualifier_string. Jika tidak, nilai berenkode base-64 harus ditetapkan ke qualifier_encoded. Nama kolom sama dengan penentu kolom. Namun, jika penentu bukan ID kolom BigQuery yang valid, yaitu tidak cocok dengan [a-zA-Z][a-zA-Z0-9_]*, ID yang valid harus diberikan sebagai field_name.
qualifierString

string

String penentu.
fieldName

string

Opsional. Jika penentu bukan ID kolom BigQuery yang valid, yaitu tidak cocok dengan [a-zA-Z][a-zA-Z0-9_]*, ID yang valid harus diberikan sebagai nama kolom dan digunakan sebagai nama kolom dalam kueri.
type

string

Opsional. Jenis untuk mengonversi nilai dalam sel kolom ini. Nilai diharapkan dienkode menggunakan fungsi Bytes.toBytes HBase saat menggunakan nilai encoding BINARY. Jenis BigQuery berikut diizinkan (peka huruf besar/kecil):

  • BYTES
  • STRING
  • INTEGER
  • FLOAT
  • BOOLEAN
  • JSON

Jenis defaultnya adalah BYTES. 'type' juga dapat ditetapkan di tingkat family kolom. Namun, setelan di tingkat ini akan diprioritaskan jika 'type' ditetapkan di kedua tingkat.
encoding

string

Opsional. Encoding nilai saat jenisnya bukan STRING. Nilai encoding yang dapat diterima adalah: TEXT - menunjukkan bahwa nilai adalah string teks alfanumerik. BINARY - menunjukkan bahwa nilai dienkode menggunakan fungsi keluarga Bytes.toBytes HBase. PROTO_BINARY - menunjukkan bahwa nilai dienkode menggunakan pesan proto yang diserialisasi. Ini hanya dapat digunakan bersama dengan jenis JSON. 'encoding' juga dapat ditetapkan di tingkat family kolom. Namun, setelan di tingkat ini akan diprioritaskan jika 'encoding' ditetapkan di kedua tingkat.
onlyReadLatest

boolean

Opsional. Jika disetel, hanya versi terbaru nilai di kolom ini yang ditampilkan. 'onlyReadLatest' juga dapat ditetapkan di tingkat grup kolom. Namun, setelan di tingkat ini akan diprioritaskan jika 'onlyReadLatest' disetel di kedua tingkat.
protoConfig

object (BigtableProtoConfig)

Opsional. Konfigurasi khusus Protobuf, hanya berlaku jika encodingnya adalah PROTO_BINARY.
Representasi JSON 
{
  "value": string
}
Kolom
value

string (bytes format)

Nilai byte.

String berenkode base64.
Representasi JSON 
{
  "schemaBundleId": string,
  "protoMessageName": string
}
Kolom
schemaBundleId

string

Opsional. ID resource SchemaBundle Bigtable yang terkait dengan protobuf ini. ID harus dirujuk dalam tabel induk, misalnya, foo, bukan projects/{project}/instances/{instance}/tables/{table}/schemaBundles/foo. Lihat detail selengkapnya tentang SchemaBundle Bigtable.
protoMessageName

string

Opsional. Nama pesan proto yang sepenuhnya memenuhi syarat dari protobuf. Dalam format "foo.bar.Message".
Representasi JSON 
{
  "skipLeadingRows": string,
  "range": string
}
Kolom
skipLeadingRows

string (Int64Value format)

Opsional. Jumlah baris di bagian atas sheet yang akan dilewati BigQuery saat membaca data. Nilai defaultnya adalah 0. Properti ini berguna jika Anda memiliki baris header yang harus dilewati. Jika deteksi otomatis aktif, perilakunya adalah sebagai berikut: * skipLeadingRows tidak ditentukan - Deteksi otomatis mencoba mendeteksi header di baris pertama. Jika tidak terdeteksi, baris akan dibaca sebagai data. Jika tidak, data dibaca mulai dari baris kedua. * skipLeadingRows adalah 0 - Menginstruksikan deteksi otomatis bahwa tidak ada header dan data harus dibaca mulai dari baris pertama. * skipLeadingRows = N > 0 - Mendeteksi otomatis akan melewati N-1 baris dan mencoba mendeteksi header di baris N. Jika header tidak terdeteksi, baris N akan dilewati. Jika tidak, baris N digunakan untuk mengekstrak nama kolom untuk skema yang terdeteksi.
range

string

Opsional. Rentang sheet yang akan digunakan untuk membuat kueri. Hanya digunakan jika tidak kosong. Format umum: sheet_name!top_left_cell_id:bottom_right_cell_id Misalnya: sheet1!A1:B20
Representasi JSON 
{
  "mode": string,
  "sourceUriPrefix": string,
  "requirePartitionFilter": boolean,
  "fields": [
    string
  ]
}
Kolom
mode

string

Opsional. Jika disetel, mode partisi Hive yang akan digunakan saat membaca data. Mode berikut didukung:

  • AUTO: secara otomatis menyimpulkan nama dan jenis kunci partisi.

  • STRING: secara otomatis menyimpulkan nama kunci partisi. Semua jenis adalah string.

  • KUSTOM: skema kunci partisi dienkode di awalan URI sumber.

Tidak semua format penyimpanan mendukung partisi Hive. Meminta partisi Hive pada format yang tidak didukung akan menyebabkan error. Format yang saat ini didukung adalah: JSON, CSV, ORC, Avro, dan Parquet.
sourceUriPrefix

string

Opsional. Saat deteksi partisi Hive diminta, imbuhan umum untuk semua URI sumber harus diperlukan. Awalan harus berakhir tepat sebelum encoding kunci partisi dimulai. Misalnya, pertimbangkan file yang mengikuti tata letak data ini:

gs://bucket/path_to_table/dt=2019-06-01/country=USA/id=7/file.avro

gs://bucket/path_to_table/dt=2019-05-31/country=CA/id=3/file.avro

Saat partisi hive diminta dengan deteksi AUTO atau STRING, awalan umum dapat berupa gs://bucket/path_to_table atau gs://bucket/path_to_table/.

Deteksi KUSTOM memerlukan encoding skema partisi segera setelah awalan umum. Untuk CUSTOM, salah satu dari

  • gs://bucket/path_to_table/{dt:DATE}/{country:STRING}/{id:INTEGER}

  • gs://bucket/path_to_table/{dt:STRING}/{country:STRING}/{id:INTEGER}

  • gs://bucket/path_to_table/{dt:DATE}/{country:STRING}/{id:STRING}

akan menjadi awalan URI sumber yang valid.
requirePartitionFilter

boolean

Opsional. Jika disetel ke benar (true), kueri atas tabel ini memerlukan filter partisi yang dapat digunakan untuk penghapusan partisi agar dapat ditentukan.

Perhatikan bahwa kolom ini hanya boleh bernilai benar saat membuat tabel eksternal permanen atau membuat kueri tabel eksternal sementara.

Pemuatan yang dipartisi Hive dengan require_partition_filter yang ditetapkan secara eksplisit ke benar (true) akan gagal.
fields[]

string

Hanya output. Untuk tabel eksternal permanen, kolom ini diisi dengan kunci partisi hive dalam urutan yang disimpulkan. Jenis kunci partisi dapat disimpulkan dengan memeriksa skema tabel (yang akan mencakup kunci partisi). Tidak semua API akan mengisi kolom ini dalam output. Misalnya, Tables.Get akan mengisinya, tetapi Tables.List tidak akan berisi kolom ini.
Representasi JSON 
{
  "useAvroLogicalTypes": boolean
}
Kolom
useAvroLogicalTypes

boolean

Opsional. Jika sourceFormat disetel ke "AVRO", menunjukkan apakah akan menafsirkan jenis logika sebagai jenis data BigQuery yang sesuai (misalnya, TIMESTAMP), bukan menggunakan jenis raw (misalnya, INTEGER).
Representasi JSON 
{
  "enumAsString": boolean,
  "enableListInference": boolean,
  "mapTargetType": enum (MapTargetType)
}
Kolom
enumAsString

boolean

Opsional. Menunjukkan apakah akan menyimpulkan jenis logis Parquet ENUM sebagai STRING, bukan BYTES secara default.
enableListInference

boolean

Opsional. Menunjukkan apakah akan menggunakan inferensi skema khusus untuk jenis logika Parquet LIST.
mapTargetType

enum (MapTargetType)

Opsional. Menunjukkan cara merepresentasikan peta Parquet jika ada.
Representasi JSON 
{
  "connectionId": string,
  "storageUri": string,
  "fileFormat": enum (FileFormat),
  "tableFormat": enum (TableFormat)
}
Kolom
connectionId

string

Opsional. Koneksi yang menentukan kredensial yang akan digunakan untuk membaca dan menulis ke penyimpanan eksternal, seperti Cloud Storage. connection_id dapat memiliki bentuk {project}.{location}.{connection_id} atau `projects/{project}/locations/{location}/connections/{connection_id}".
storageUri

string

Opsional. Awalan lokasi yang sepenuhnya memenuhi syarat dari folder eksternal tempat data tabel disimpan. Karakter pengganti '*' tidak diizinkan. URI harus dalam format gs://bucket/path_to_table/
fileFormat

enum (FileFormat)

Opsional. Format file tempat data tabel disimpan.
tableFormat

enum (TableFormat)

Opsional. Format tabel tempat snapshot hanya metadata disimpan.
Representasi JSON 
{
  "estimatedBytes": string,
  "estimatedRows": string,
  "oldestEntryTime": string
}
Kolom
estimatedBytes

string

Hanya output. Perkiraan batas bawah jumlah byte yang saat ini ada di buffer streaming.
estimatedRows

string

Hanya output. Perkiraan batas bawah jumlah baris yang saat ini ada di buffer streaming.
oldestEntryTime

string (uint64 format)

Hanya output. Berisi stempel waktu entri terlama di buffer streaming, dalam milidetik sejak epoch, jika buffer streaming tersedia.
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 
{
  "baseTableReference": {
    object (TableReference)
  },
  "snapshotTime": string
}
Kolom
baseTableReference

object (TableReference)

Wajib. Referensi yang menjelaskan ID tabel yang diambil snapshot-nya.
snapshotTime

string (Timestamp format)

Wajib. Waktu saat tabel dasar diambil snapshot-nya. Nilai ini dilaporkan dalam respons JSON menggunakan format RFC3339.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
Representasi JSON 
{
  "baseTableReference": {
    object (TableReference)
  },
  "cloneTime": string
}
Kolom
baseTableReference

object (TableReference)

Wajib. Referensi yang menjelaskan ID tabel yang di-clone.
cloneTime

string (Timestamp format)

Wajib. Waktu saat tabel dasar di-clone. Nilai ini dilaporkan dalam respons JSON menggunakan format RFC3339.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
Representasi JSON 
{
  "type": enum (RestrictionType)
}
Kolom
type

enum (RestrictionType)

Hanya output. Menentukan jenis batasan set data/tabel.
Representasi JSON 
{
  "primaryKey": {
    object (PrimaryKey)
  },
  "foreignKeys": [
    {
      object (ForeignKey)
    }
  ]
}
Kolom
primaryKey

object (PrimaryKey)

Opsional. Mewakili batasan kunci utama pada kolom tabel. Hanya ada jika tabel memiliki kunci utama. Kunci utama tidak diterapkan.
foreignKeys[]

object (ForeignKey)

Opsional. Hanya ada jika tabel memiliki kunci asing. Kunci asing tidak diterapkan.
Representasi JSON 
{
  "columns": [
    string
  ]
}
Kolom
columns[]

string

Wajib. Kolom yang terdiri dari batasan kunci utama.
Representasi JSON 
{
  "name": string,
  "referencedTable": {
    object (TableReference)
  },
  "columnReferences": [
    {
      object (ColumnReference)
    }
  ]
}
Kolom
name

string

Opsional. Hanya disetel jika batasan kunci asing diberi nama.
referencedTable

object (TableReference)

Wajib. Tabel yang menyimpan kunci utama dan dirujuk oleh kunci asing ini.
columnReferences[]

object (ColumnReference)

Wajib. Kolom yang membentuk kunci asing.
Representasi JSON 
{
  "referencingColumn": string,
  "referencedColumn": string
}
Kolom
referencingColumn

string

Wajib. Kolom yang membentuk kunci asing.
referencedColumn

string

Wajib. Kolom dalam kunci utama yang direferensikan oleh referencing_column.
Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string
Representasi JSON 
{
  "sourceTable": {
    object (TableReference)
  },
  "replicationIntervalMs": string,
  "replicatedSourceLastRefreshTime": string,
  "replicationStatus": enum (ReplicationStatus),
  "replicationError": {
    object (ErrorProto)
  }
}
Kolom
sourceTable

object (TableReference)

Wajib. Referensi tabel sumber yang direplikasi.
replicationIntervalMs

string (int64 format)

Opsional. Menentukan interval saat tabel sumber di-polling untuk mendapatkan update. Opsional. Jika tidak ditentukan, interval replikasi default akan diterapkan.
replicatedSourceLastRefreshTime

string (int64 format)

Opsional. Hanya output. Jika sumber adalah tampilan terwujud, kolom ini menandakan waktu refresh terakhir sumber.
replicationStatus

enum (ReplicationStatus)

Opsional. Hanya output. Status replikasi dari replikasi yang dikonfigurasi.
replicationError

object (ErrorProto)

Opsional. Hanya output. Error replikasi yang akan menghentikan replikasi tabel secara permanen.
Representasi JSON 
{
  "parameters": {
    string: string,
    ...
  },
  "storageDescriptor": {
    object (StorageDescriptor)
  },
  "connectionId": string
}
Kolom
parameters

map (key: string, value: string)

Opsional. Peta key-value pair yang menentukan parameter dan properti tabel open source. Sesuai dengan parameter tabel metastore Hive. Ukuran maksimum 4 MiB.

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

object (StorageDescriptor)

Opsional. Deskripsi penyimpanan yang berisi informasi tentang penyimpanan fisik tabel ini.
connectionId

string

Opsional. ID koneksi yang menentukan kredensial yang akan digunakan untuk membaca penyimpanan eksternal, seperti Azure Blob, Cloud Storage, atau Amazon S3. Koneksi ini diperlukan untuk membaca tabel open source dari BigQuery. Format connection_id harus <project_id>.<location_id>.<connection_id> atau projects/<project_id>/locations/<location_id>/connections/<connection_id>.
Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string
Representasi JSON 
{
  "locationUri": string,
  "inputFormat": string,
  "outputFormat": string,
  "serdeInfo": {
    object (SerDeInfo)
  }
}
Kolom
locationUri

string

Opsional. Lokasi fisik tabel (misalnya, gs://spark-dataproc-data/pangea-data/case_sensitive/ atau gs://spark-dataproc-data/pangea-data/*). Panjang maksimum adalah 2056 byte.
inputFormat

string

Opsional. Menentukan nama class InputFormat yang sepenuhnya memenuhi syarat (misalnya, "org.apache.hadoop.hive.ql.io.orc.OrcInputFormat"). Panjang maksimum adalah 128 karakter.
outputFormat

string

Opsional. Menentukan nama class OutputFormat yang sepenuhnya memenuhi syarat (misalnya, "org.apache.hadoop.hive.ql.io.orc.OrcOutputFormat"). Panjang maksimum adalah 128 karakter.
serdeInfo

object (SerDeInfo)

Opsional. Informasi serializer dan deserializer.
Representasi JSON 
{
  "name": string,
  "serializationLibrary": string,
  "parameters": {
    string: string,
    ...
  }
}
Kolom
name

string

Opsional. Nama SerDe. Panjang maksimumnya adalah 256 karakter.
serializationLibrary

string

Wajib. Menentukan nama class yang sepenuhnya memenuhi syarat dari library serialisasi yang bertanggung jawab atas terjemahan data antara representasi tabel dan struktur format input dan output tingkat rendah yang mendasarinya. Panjang maksimumnya adalah 256 karakter.
parameters

map (key: string, value: string)

Opsional. Key-value pair yang menentukan parameter inisialisasi untuk library serialisasi. Ukuran maksimum 10 KiB.

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

string
value

string

Anotasi Alat

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