MCP Tools Reference: bigquery.googleapis.com

Strumento: get_table_info

Recuperare informazioni sui metadati di una tabella BigQuery.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP get_table_info.

Curl Request
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 }'

Schema di input

Richiesta di una tabella.

Rappresentazione JSON
{ "projectId": string, "datasetId": string, "tableId": string }

Campi
projectId	string Obbligatorio. ID progetto della richiesta di tabella.
datasetId	string Obbligatorio. ID set di dati della richiesta di tabella.
tableId	string Obbligatorio. ID tabella della richiesta di tabella.

Schema di output

Rappresentazione 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. }

Campi
kind	string Il tipo di ID risorsa.
etag	string Solo output. Un hash di questa risorsa.
id	string Solo output. Un ID opaco che identifica in modo univoco la tabella.
selfLink	string Solo output. Un URL che può essere utilizzato per accedere di nuovo a questa risorsa.
tableReference	object (TableReference) Obbligatorio. Riferimento che descrive l'ID di questa tabella.
friendlyName	string Facoltativo. Un nome descrittivo per questa tabella.
description	string Facoltativo. Una descrizione intuitiva di questa tabella.
labels	map (key: string, value: string) Le etichette associate a questa tabella. Puoi utilizzarli per organizzare e raggruppare le tabelle. I valori e le chiavi di etichetta non devono superare i 63 caratteri e possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Sono consentiti caratteri internazionali. I valori delle etichette sono facoltativi. Le chiavi di etichetta devono iniziare con una lettera e ogni etichetta dell'elenco deve avere una chiave diversa. Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
schema	object (TableSchema) Facoltativo. Descrive lo schema di questa tabella.
timePartitioning	object (TimePartitioning) Se specificato, configura il partizionamento basato sul tempo per questa tabella.
rangePartitioning	object (RangePartitioning) Se specificato, configura il partizionamento per intervallo per questa tabella.
clustering	object (Clustering) Specifica di clustering per la tabella. Deve essere specificato con il partizionamento basato sul tempo. I dati nella tabella verranno prima partizionati e successivamente raggruppati in cluster.
requirePartitionFilter	boolean Facoltativo. Se impostato su true, le query su questa tabella richiedono la specifica di un filtro di partizionamento che può essere utilizzato per l'eliminazione della partizione.
numBytes	string (Int64Value format) Solo output. Le dimensioni di questa tabella in byte logici, esclusi i dati nel buffer di streaming.
numPhysicalBytes	string (Int64Value format) Solo output. Le dimensioni fisiche di questa tabella in byte. Ciò include lo spazio di archiviazione utilizzato per il time travel.
numLongTermBytes	string (Int64Value format) Solo output. Il numero di byte logici nella tabella considerati "archiviazione a lungo termine".
numRows	string (UInt64Value format) Solo output. Il numero di righe di dati in questa tabella, esclusi i dati nel buffer di streaming.
creationTime	string (int64 format) Solo output. L'ora in cui è stata creata questa tabella, in millisecondi dall'epoca.
expirationTime	string (Int64Value format) Facoltativo. L'ora di scadenza di questa tabella, in millisecondi dall'epoca. Se non è presente, la tabella verrà mantenuta a tempo indeterminato. Le tabelle scadute verranno eliminate e lo spazio di archiviazione recuperato. La proprietà defaultTableExpirationMs del set di dati di inclusione può essere utilizzata per impostare un valore predefinito per expirationTime nelle tabelle appena create.
lastModifiedTime	string (uint64 format) Solo output. L'ora dell'ultima modifica di questa tabella, in millisecondi dall'epoca.
type	string Solo output. Descrive il tipo di tabella. Sono supportati i seguenti valori: TABLE: una normale tabella BigQuery. VIEW: una tabella virtuale definita da una query SQL. EXTERNAL: una tabella che fa riferimento ai dati archiviati in un sistema di archiviazione esterno, ad esempio Google Cloud Storage. MATERIALIZED_VIEW: una vista precalcolata definita da una query SQL. SNAPSHOT: una tabella BigQuery immutabile che conserva i contenuti di una tabella di base in un determinato momento. Per ulteriori informazioni, consulta la sezione Snapshot delle tabelle. Il valore predefinito è TABLE.
view	object (ViewDefinition) Facoltativo. La definizione della visualizzazione.
materializedView	object (MaterializedViewDefinition) Facoltativo. La definizione della vista materializzata.
materializedViewStatus	object (MaterializedViewStatus) Solo output. Lo stato della vista materializzata.
externalDataConfiguration	object (ExternalDataConfiguration) Facoltativo. Descrive il formato, la posizione e altre proprietà di una tabella archiviata al di fuori di BigQuery. Definendo queste proprietà, l'origine dati può essere interrogata come se fosse una tabella BigQuery standard.
biglakeConfiguration	object (BigLakeConfiguration) Facoltativo. Specifica la configurazione di una tabella BigQuery per Apache Iceberg.
managedTableType	enum (ManagedTableType) Facoltativo. Se impostato, esegue l'override del tipo di tabella gestita predefinito configurato nel set di dati.
location	string Solo output. La posizione geografica in cui si trova la tabella. Questo valore viene ereditato dal set di dati.
streamingBuffer	object (Streamingbuffer) Solo output. Contiene informazioni sul buffer di streaming di questa tabella, se presente. Questo campo non sarà presente se la tabella non viene trasmessa in streaming o se non sono presenti dati nel buffer di streaming.
encryptionConfiguration	object (EncryptionConfiguration) Configurazione della crittografia personalizzata (ad es. chiavi Cloud KMS).
snapshotDefinition	object (SnapshotDefinition) Solo output. Contiene informazioni sullo snapshot. Questo valore viene impostato tramite la creazione dello snapshot.
defaultCollation	string Facoltativo. Definisce la specifica delle regole di confronto predefinite dei nuovi campi STRING nella tabella. Durante la creazione o l'aggiornamento della tabella, se a questa tabella viene aggiunto un campo STRINGA senza regole di confronto esplicite, la tabella eredita le regole di confronto predefinite. Una modifica a questo campo influisce solo sui campi aggiunti successivamente e non altera i campi esistenti. Sono supportati i seguenti valori: 'und:ci': impostazioni internazionali non determinate, senza distinzione tra maiuscole e minuscole. "": stringa vuota. Per impostazione predefinita viene applicato il comportamento sensibile alle maiuscole.
defaultRoundingMode	enum (RoundingMode) Facoltativo. Definisce la specifica della modalità di arrotondamento predefinita dei nuovi campi decimali (NUMERIC O BIGNUMERIC) nella tabella. Durante la creazione o l'aggiornamento della tabella, se a questa tabella viene aggiunto un campo decimale senza specificare una modalità di arrotondamento esplicita, il campo eredita la modalità di arrotondamento predefinita della tabella. La modifica di questo campo non influisce sui campi esistenti.
cloneDefinition	object (CloneDefinition) Solo output. Contiene informazioni sul clone. Questo valore viene impostato tramite l'operazione di clonazione.
numTimeTravelPhysicalBytes	string (Int64Value format) Solo output. Numero di byte fisici utilizzati dallo spazio di archiviazione Time Travel (dati eliminati o modificati). Questi dati non vengono aggiornati in tempo reale e potrebbero essere ritardati di alcuni secondi o minuti.
numTotalLogicalBytes	string (Int64Value format) Solo output. Numero totale di byte logici nella tabella o nella vista materializzata.
numActiveLogicalBytes	string (Int64Value format) Solo output. Numero di byte logici risalenti a meno di 90 giorni fa.
numLongTermLogicalBytes	string (Int64Value format) Solo output. Numero di byte logici che risalgono a più di 90 giorni fa.
numCurrentPhysicalBytes	string (Int64Value format) Solo output. Numero di byte fisici utilizzati dall'attuale spazio di archiviazione dei dati attivi. Questi dati non vengono aggiornati in tempo reale e potrebbero essere ritardati di alcuni secondi o minuti.
numTotalPhysicalBytes	string (Int64Value format) Solo output. Le dimensioni fisiche di questa tabella in byte. Sono inclusi anche i dati archiviati per la funzionalità Time Travel. Questi dati non vengono aggiornati in tempo reale e potrebbero essere ritardati di alcuni secondi o minuti.
numActivePhysicalBytes	string (Int64Value format) Solo output. Numero di byte fisici risalenti a meno di 90 giorni fa. Questi dati non vengono aggiornati in tempo reale e potrebbero essere ritardati di alcuni secondi o minuti.
numLongTermPhysicalBytes	string (Int64Value format) Solo output. Numero di byte fisici con più di 90 giorni. Questi dati non vengono aggiornati in tempo reale e potrebbero essere ritardati di alcuni secondi o minuti.
numPartitions	string (Int64Value format) Solo output. Il numero di partizioni presenti nella tabella o nella vista materializzata. Questi dati non vengono aggiornati in tempo reale e potrebbero essere ritardati di alcuni secondi o minuti.
maxStaleness	string Facoltativo. L'inattività massima dei dati che potrebbero essere restituiti quando viene eseguita una query sulla tabella (o sulla MV obsoleta). L'obsolescenza codificata come codifica di stringa del tipo IntervalValue SQL.
restrictions	object (RestrictionConfig) Facoltativo. Solo output. Configurazione della limitazione per la tabella. Se impostato, limita determinati accessi alla tabella in base alla configurazione. Per ulteriori dettagli, consulta la sezione Egress dei dati.
tableConstraints	object (TableConstraints) Facoltativo. Informazioni su chiave primaria e chiave esterna delle tabelle
resourceTags	map (key: string, value: string) Facoltativo. I tag associati a questa tabella. Le chiavi dei tag sono univoche a livello globale. La chiave del tag deve essere nel formato con spazio dei nomi, ad esempio "123456789012/environment", dove 123456789012 è l'ID della risorsa organizzazione o progetto principale per questa chiave del tag. Il valore tag deve essere il nome breve, ad esempio "Production". Per ulteriori dettagli, consulta la sezione Definizioni dei tag. Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
tableReplicationInfo	object (TableReplicationInfo) Facoltativo. Informazioni sulla replica della tabella per la tabella creata con DDL AS REPLICA come: CREATE MATERIALIZED VIEW mv1 AS REPLICA OF src_mv
replicas[]	object (TableReference) Facoltativo. Solo output. Riferimenti alla tabella di tutte le repliche attualmente attive nella tabella.
externalCatalogTableOptions	object (ExternalCatalogTableOptions) Facoltativo. Opzioni che definiscono la tabella compatibile con l'open source.
Campo unione _partition_definition. _partition_definition può essere solo uno dei seguenti tipi:
partitionDefinition	object (PartitioningDefinition) Facoltativo. Le informazioni sulle partizioni per tutti i formati di tabella, incluse le tabelle partizionate gestite, le tabelle partizionate Hive, le tabelle partizionate Iceberg e le tabelle partizionate metastore. Questo campo viene compilato solo per le tabelle partizionate del metastore. Per gli altri formati di tabella, questo è un campo solo di output.

Rappresentazione JSON
{ "projectId": string, "datasetId": string, "tableId": string, "projectIdAlternative": [ string ], "datasetIdAlternative": [ string ], "tableIdAlternative": [ string ] }

Campi
projectId	string Obbligatorio. L'ID del progetto contenente questa tabella.
datasetId	string Obbligatorio. L'ID del set di dati contenente questa tabella.
tableId	string Obbligatorio. L'ID della tabella. L'ID può contenere caratteri Unicode nelle categorie L (lettera), M (segno), N (numero), Pc (connettore, incluso il trattino basso), Pd (trattino) e Zs (spazio). Per ulteriori informazioni, consulta la sezione Categoria generale. La lunghezza massima è di 1024 caratteri. Alcune operazioni consentono di aggiungere un suffisso all'ID tabella con un decoratore di partizione, ad esempio sample_table$20190123.
projectIdAlternative[]	string Questo campo non deve essere utilizzato.
datasetIdAlternative[]	string Questo campo non deve essere utilizzato.
tableIdAlternative[]	string Questo campo non deve essere utilizzato.

Rappresentazione JSON
{ "value": string }

Campi
value	string Il valore stringa.

Rappresentazione JSON
{ "key": string, "value": string }

Campi
key	string
value	string

Rappresentazione JSON
{ "fields": [ { object (TableFieldSchema) } ], "foreignTypeInfo": { object (ForeignTypeInfo) } }

Campi
fields[]	object (TableFieldSchema) Descrive i campi di una tabella.
foreignTypeInfo	object (ForeignTypeInfo) Facoltativo. Specifica i metadati della definizione del tipo di dati esterni nello schema del campo (TableFieldSchema.foreign_type_definition).

Rappresentazione 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 }

Campi
name	string Obbligatorio. Il nome del campo. Il nome deve contenere solo lettere (a-z, A-Z), numeri (0-9) o trattini bassi (_) e deve iniziare con una lettera o un trattino basso. La lunghezza massima è di 300 caratteri.
type	string Obbligatorio. Il tipo di dati del campo. I valori possibili sono: STRING BYTES NUMERO INTERO (o INT64) FLOAT (o FLOAT64) BOOLEANO (o BOOL) TIMESTAMP DATA TEMPO DATETIME GEOGRAPHY NUMERIC BIGNUMERIC JSON RECORD (o STRUCT) RANGE L'utilizzo di RECORD/STRUCT indica che il campo contiene uno schema nidificato.
mode	string Facoltativo. La modalità del campo. I valori possibili includono NULLABLE, REQUIRED e REPEATED. Il valore predefinito è NULLABLE.
fields[]	object (TableFieldSchema) Facoltativo. Descrive i campi dello schema nidificati se la proprietà type è impostata su RECORD.
description	string Facoltativo. La descrizione del campo. La lunghezza massima è di 1024 caratteri.
policyTags	object (PolicyTagList) Facoltativo. I tag criterio collegati a questo campo, utilizzati per controllo dell'accesso a livello di campo. Se non viene impostato, il valore predefinito è policy_tags vuoto.
dataPolicies[]	object (DataPolicyOption) Facoltativo. Policy dei dati associate a questo campo, utilizzate per controllo dell'accesso a livello di campo.
nameAlternative[]	string Questo campo non deve essere utilizzato.
maxLength	string (int64 format) Facoltativo. Lunghezza massima dei valori di questo campo per STRINGHE o BYTE. Se max_length non è specificato, non viene imposto alcun vincolo di lunghezza massima a questo campo. Se type = "STRING", max_length rappresenta la lunghezza massima UTF-8 delle stringhe in questo campo. Se type = "BYTES", max_length rappresenta il numero massimo di byte in questo campo. Non è valido impostare questo campo se type ≠ "STRING" e ≠ "BYTES".
precision	string (int64 format) Facoltativo. Vincoli di precisione (numero massimo di cifre totali in base 10) e scala (numero massimo di cifre nella parte frazionaria in base 10) per i valori di questo campo per NUMERIC o BIGNUMERIC. Non è valido impostare la precisione o la scala se il tipo è diverso da "NUMERIC" e "BIGNUMERIC". Se non vengono specificati precisione e scala, a questo campo non viene imposto alcun vincolo di intervallo di valori, a condizione che i valori siano consentiti dal tipo. I valori di questo campo NUMERIC o BIGNUMERIC devono essere compresi in questo intervallo quando: Sono specificati precisione (P) e scala (S): [-10^P-S + 10^-S, 10^P-S - 10^-S] La precisione (P) è specificata, ma non la scala (che quindi viene interpretata come uguale a zero): [-10^P + 1, 10^P - 1]. Valori accettabili per precisione e scala se vengono specificati entrambi: Se type = "NUMERIC": 1 ≤ precision - scale ≤ 29 e 0 ≤ scale ≤ 9. Se type = "BIGNUMERIC": 1 ≤ precisione - scalabilità ≤ 38 e 0 ≤ scalabilità ≤ 38. Valori accettabili per la precisione se viene specificata solo la precisione, ma non la scala (e quindi la scala viene interpretata come uguale a zero): Se type = "NUMERIC": 1 ≤ precision ≤ 29. Se type = "BIGNUMERIC": 1 ≤ precision ≤ 38. Se la scala è specificata, ma non la precisione, il valore non è valido.
scale	string (int64 format) Facoltativo. Per informazioni dettagliate, consulta la documentazione.
timestampPrecision	string (Int64Value format) Facoltativo. Precisione (numero massimo di cifre totali in base 10) per i secondi del tipo TIMESTAMP. I valori possibili includono: * 6 (valore predefinito per il tipo TIMESTAMP con precisione al microsecondo) * 12 (per il tipo TIMESTAMP con precisione al picosecondo)
roundingMode	enum (RoundingMode) Facoltativo. Specifica la modalità di arrotondamento da utilizzare per l'archiviazione dei valori di tipo NUMERIC e BIGNUMERIC.
collation	string Facoltativo. L'ordinamento dei campi può essere impostato solo quando il tipo di campo è STRING. Sono supportati i seguenti valori: 'und:ci': impostazioni internazionali non determinate, senza distinzione tra maiuscole e minuscole. "": stringa vuota. Per impostazione predefinita viene applicato il comportamento sensibile alle maiuscole.
defaultValueExpression	string Facoltativo. Un'espressione SQL per specificare il valore predefinito per questo campo.
rangeElementType	object (FieldElementType) Facoltativo. Il sottotipo di RANGE, se il tipo di questo campo è RANGE. Se il tipo è INTERVALLO, questo campo è obbligatorio. I valori per il tipo di elemento del campo possono essere i seguenti: DATA DATETIME TIMESTAMP
foreignTypeDefinition	string Facoltativo. Definizione del tipo di dati esterni. Valido solo per i campi dello schema di primo livello (non per i campi nidificati). Se il tipo è ESTERO, questo campo è obbligatorio.

Rappresentazione JSON
{ "names": [ string ] }

Campi
names[]	string Un elenco di nomi di risorse tag di criteri. Ad esempio, "projects/1/locations/eu/taxonomies/2/policyTags/3". Al momento è consentito al massimo un tag di criteri.

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

Campi
Campo unione _name. _name può essere solo uno dei seguenti tipi:
name	string Nome risorsa del criterio di gestione dei dati nel formato projects/project_id/locations/location_id/dataPolicies/data_policy_id.

Rappresentazione JSON
{ "value": string }

Campi
value	string (int64 format) Il valore int64.

Rappresentazione JSON
{ "type": string }

Campi
type	string Obbligatorio. Il tipo di un elemento del campo. Per ulteriori informazioni, vedi TableFieldSchema.type.

Rappresentazione JSON
{ "typeSystem": enum (TypeSystem) }

Campi
typeSystem	enum (TypeSystem) Obbligatorio. Specifica il sistema che definisce il tipo di dati esterni.

Rappresentazione JSON
{ "type": string, "expirationMs": string, "field": string, "requirePartitionFilter": boolean }

Campi
type	string Obbligatorio. I tipi supportati sono DAY, HOUR, MONTH e YEAR, che genereranno una partizione al giorno, all'ora, al mese e all'anno, rispettivamente.
expirationMs	string (Int64Value format) Facoltativo. Numero di millisecondi per cui conservare lo spazio di archiviazione per una partizione. Qui viene utilizzato un wrapper perché 0 è un valore non valido.
field	string Facoltativo. Se non è impostato, la tabella viene partizionata in base alla pseudocolonna "_PARTITIONTIME"; se è impostato, la tabella viene partizionata in base a questo campo. Il campo deve essere un campo TIMESTAMP o DATE di primo livello. La modalità deve essere NULLABLE o REQUIRED. Qui viene utilizzato un wrapper perché una stringa vuota è un valore non valido.
requirePartitionFilter (deprecated)	boolean Questo elemento è deprecato. Se impostato su true, le query su questa tabella richiedono la specifica di un filtro di partizionamento che può essere utilizzato per l'eliminazione della partizione. Questo campo è ritirato. Imposta invece il campo con lo stesso nome nella tabella stessa. Questo campo richiede un wrapper perché vogliamo restituire il valore predefinito, false, se l'utente lo ha impostato in modo esplicito.

Rappresentazione JSON
{ "value": boolean }

Campi
value	boolean Il valore booleano.

Rappresentazione JSON
{ "field": string, "range": { object (Range) } }

Campi
field	string Obbligatorio. Il nome della colonna in base alla quale partizionare la tabella. Deve essere una colonna INT64 di primo livello la cui modalità è NULLABLE o REQUIRED.
range	object (Range) Definisce gli intervalli per il partizionamento degli intervalli.

Rappresentazione JSON
{ "start": string, "end": string, "interval": string }

Campi
start	string Obbligatorio. L'inizio del partizionamento degli intervalli, incluso. Questo campo è un valore INT64 rappresentato come stringa.
end	string Obbligatorio. La fine del partizionamento degli intervalli, esclusa. Questo campo è un valore INT64 rappresentato come stringa.
interval	string Obbligatorio. La larghezza di ogni intervallo. Questo campo è un valore INT64 rappresentato come stringa.

Rappresentazione JSON
{ "fields": [ string ] }

Campi
fields[]	string Uno o più campi su cui raggruppare i dati. Sono supportati solo i campi di primo livello, non ripetuti e di tipo semplice. L'ordine dei campi di clustering deve essere prioritario dal più importante al meno importante ai fini del filtraggio. Per ulteriori informazioni, consulta la sezione Introduzione alle tabelle in cluster.

Rappresentazione JSON
{ "partitionedColumn": [ { object (PartitionedColumn) } ] }

Campi

partitionedColumn[]

object (PartitionedColumn) Facoltativo. Dettagli su ogni colonna di partizionamento. Questo campo viene restituito solo per tutti i tipi di partizionamento diversi dalle tabelle partizionate del metastore. Le tabelle native BigQuery supportano una sola colonna di partizionamento. Altri tipi di tabelle potrebbero supportare 0, 1 o più colonne di partizionamento. Per le tabelle partizionate del metastore, l'ordine deve corrispondere all'ordine di definizione in Hive Metastore, dove deve corrispondere al layout fisico della tabella. Ad esempio, CREATE TABLE a_table(id BIGINT, name STRING) PARTITIONED BY (city STRING, state STRING). In questo caso, i valori devono essere ["city", "state"] in questo ordine.

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

Campi
Campo unione _field. _field può essere solo uno dei seguenti tipi:
field	string Obbligatorio. Il nome della colonna di partizione.

Rappresentazione JSON
{ "value": string }

Campi
value	string Il valore uint64.

Rappresentazione JSON
{ "query": string, "userDefinedFunctionResources": [ { object (UserDefinedFunctionResource) } ], "useLegacySql": boolean, "useExplicitColumnNames": boolean, "privacyPolicy": { object (PrivacyPolicy) }, "foreignDefinitions": [ { object (ForeignViewDefinition) } ] }

Campi
query	string Obbligatorio. Una query che BigQuery esegue quando viene fatto riferimento alla vista.
userDefinedFunctionResources[]	object (UserDefinedFunctionResource) Descrive le risorse funzione definita dall'utente dall'utente utilizzate nella query.
useLegacySql	boolean Specifica se utilizzare SQL precedente di BigQuery per questa vista. Il valore predefinito è true. Se impostato su false, la visualizzazione utilizzerà GoogleSQL di BigQuery: https://cloud.google.com/bigquery/sql-reference/ Le query e le visualizzazioni che fanno riferimento a questa visualizzazione devono utilizzare lo stesso valore del flag. Qui viene utilizzato un wrapper perché il valore predefinito è True.
useExplicitColumnNames	boolean True se i nomi delle colonne sono specificati in modo esplicito. Ad esempio, utilizzando la sintassi "CREATE VIEW v(c1, c2) AS ...". Può essere impostato solo per le viste GoogleSQL.
privacyPolicy	object (PrivacyPolicy) Facoltativo. Specifica le norme sulla privacy per la visualizzazione.
foreignDefinitions[]	object (ForeignViewDefinition) Facoltativo. Rappresentazioni di visualizzazioni estere.

Rappresentazione JSON
{ "resourceUri": string, "inlineCode": string, "inlineCodeAlternative": [ string ] }

Campi
resourceUri	string [Scegli una delle opzioni] Una risorsa di codice da caricare da un URI Google Cloud Storage (gs://bucket/path).
inlineCode	string [Scegli una delle opzioni] Una risorsa incorporata che contiene il codice per una funzione definita dall'utente dall'utente. Fornire una risorsa di codice inline equivale a fornire un URI per un file contenente lo stesso codice.
inlineCodeAlternative[]	string

Rappresentazione 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. }

Campi
Campo unione privacy_policy. Norme sulla privacy associate a questa specifica dei requisiti. È consentito un solo metodo di privacy per oggetto dell'origine dati. privacy_policy può essere solo uno dei seguenti tipi:
aggregationThresholdPolicy	object (AggregationThresholdPolicy) Facoltativo. Criterio utilizzato per le soglie di aggregazione.
differentialPrivacyPolicy	object (DifferentialPrivacyPolicy) Facoltativo. Norme utilizzate per la privacy differenziale.
Campo unione _join_restriction_policy. _join_restriction_policy può essere solo uno dei seguenti tipi:
joinRestrictionPolicy	object (JoinRestrictionPolicy) Facoltativo. La policy di limitazione dell'unione non rientra in una delle policy, in quanto può essere impostata insieme ad altre policy. Questo criterio consente ai fornitori di dati di applicare i join alle colonne "join_allowed_columns" quando i dati vengono interrogati da una visualizzazione protetta dalla privacy.

Rappresentazione 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. }

Campi
privacyUnitColumns[]	string Facoltativo. Le colonne unità privacy associate a queste norme. Per il momento, è consentita una sola colonna per oggetto origine dati (tabella, visualizzazione) come colonna unità privacy. Rappresentazione come campo ripetuto nei metadati per l'estensibilità a più colonne in futuro. Non sono consentiti campi struct duplicati e ripetuti. Per i campi nidificati, utilizza la notazione con il punto ("outer.inner")
Campo unione _threshold. _threshold può essere solo uno dei seguenti tipi:
threshold	string (int64 format) Facoltativo. La soglia per il criterio "Soglia di aggregazione".

Rappresentazione 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. }

Campi
Campo unione _max_epsilon_per_query. _max_epsilon_per_query può essere solo uno dei seguenti tipi:
maxEpsilonPerQuery	number Facoltativo. Il valore epsilon massimo che una query può utilizzare. Se l'abbonato specifica epsilon come parametro in una query SELECT, questo valore deve essere inferiore o uguale a questo valore. Il parametro epsilon controlla la quantità di rumore aggiunta ai gruppi. Un valore di epsilon più alto significa meno rumore.
Campo unione _delta_per_query. _delta_per_query può essere solo uno dei seguenti tipi:
deltaPerQuery	number Facoltativo. Il valore delta utilizzato per query. Delta rappresenta la probabilità che una riga non soddisfi la privacy differenziale epsilon. Indica il rischio associato all'esposizione di righe aggregate nel risultato di una query.
Campo unione _max_groups_contributed. _max_groups_contributed può essere solo uno dei seguenti tipi:
maxGroupsContributed	string (int64 format) Facoltativo. Il valore massimo dei gruppi a cui è stato contribuito utilizzato per query. Rappresenta il numero massimo di gruppi a cui ogni entità protetta può contribuire. La modifica di questo valore non migliora né peggiora la privacy. Il valore migliore per l'accuratezza e l'utilità dipende dalla query e dai dati.
Campo unione _privacy_unit_column. _privacy_unit_column può essere solo uno dei seguenti tipi:
privacyUnitColumn	string Facoltativo. La colonna unità privacy associata a queste norme. I criteri di privacy differenziale possono avere una sola colonna unità di privacy per oggetto origine dati (tabella, vista).
Campo unione _epsilon_budget. _epsilon_budget può essere solo uno dei seguenti tipi:
epsilonBudget	number Facoltativo. Il budget epsilon totale per tutte le query rispetto alla visualizzazione protetta della privacy. Ogni query di un abbonato su questa visualizzazione addebita l'importo di epsilon richiesto nella query. Se il budget è sufficiente, il tentativo di completamento della query dell'abbonato viene eseguito. Potrebbe comunque non andare a buon fine per altri motivi, nel qual caso l'addebito viene rimborsato. Se il budget è insufficiente, la query viene rifiutata. Potrebbero essere effettuati più tentativi di addebito se una singola query fa riferimento a più visualizzazioni. In questo caso, deve essere disponibile un budget sufficiente per tutti gli addebiti, altrimenti la query viene rifiutata e gli addebiti vengono rimborsati nel miglior modo possibile. Il budget non ha una norma di aggiornamento e può essere aggiornato solo tramite ALTER VIEW o aggirato creando una nuova vista che può essere interrogata con un budget aggiornato.
Campo unione _delta_budget. _delta_budget può essere solo uno dei seguenti tipi:
deltaBudget	number Facoltativo. Il budget delta totale per tutte le query sulla visualizzazione protetta dalla privacy. Ogni query del sottoscrittore su questa visualizzazione addebita l'importo del delta predefinito dal collaboratore tramite il campo delta_per_query delle norme sulla privacy. Se il budget è sufficiente, il tentativo di completamento della query dell'abbonato viene eseguito. Potrebbe comunque non andare a buon fine per altri motivi, nel qual caso l'addebito viene rimborsato. Se il budget è insufficiente, la query viene rifiutata. Potrebbero essere effettuati più tentativi di addebito se una singola query fa riferimento a più visualizzazioni. In questo caso, deve essere disponibile un budget sufficiente per tutti gli addebiti, altrimenti la query viene rifiutata e gli addebiti vengono rimborsati nel miglior modo possibile. Il budget non ha una norma di aggiornamento e può essere aggiornato solo tramite ALTER VIEW o aggirato creando una nuova vista che può essere interrogata con un budget aggiornato.
Campo unione _epsilon_budget_remaining. _epsilon_budget_remaining può essere solo uno dei seguenti tipi:
epsilonBudgetRemaining	number Solo output. Il budget epsilon rimanente. Se il budget è esaurito, non sono consentite altre query. Tieni presente che il budget per le query in corso viene detratto prima dell'esecuzione della query. Se la query non va a buon fine o viene annullata, il budget viene rimborsato. In questo caso, l'importo del budget rimanente può aumentare.
Campo unione _delta_budget_remaining. _delta_budget_remaining può essere solo uno dei seguenti tipi:
deltaBudgetRemaining	number Solo output. Il budget delta rimanente. Se il budget è esaurito, non sono consentite altre query. Tieni presente che il budget per le query in corso viene detratto prima dell'esecuzione della query. Se la query non va a buon fine o viene annullata, il budget viene rimborsato. In questo caso, l'importo del budget rimanente può aumentare.

Rappresentazione 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. }

Campi
joinAllowedColumns[]	string Facoltativo. Sono consentite solo le colonne in cui sono attive le unioni. Questo campo deve essere specificato per join_conditions JOIN_ANY e JOIN_ALL e non può essere impostato per JOIN_BLOCKED.
Campo unione _join_condition. _join_condition può essere solo uno dei seguenti tipi:
joinCondition	enum (JoinCondition) Facoltativo. Specifica se è necessario o meno un join nelle query per la visualizzazione. Il valore predefinito è JOIN_CONDITION_UNSPECIFIED.

Rappresentazione JSON
{ "query": string, "dialect": string }

Campi
query	string Obbligatorio. La query che definisce la visualizzazione.
dialect	string Facoltativo. Rappresenta il dialetto della query.

Rappresentazione JSON
{ "query": string, "lastRefreshTime": string, "enableRefresh": boolean, "refreshIntervalMs": string, "allowNonIncrementalDefinition": boolean }

Campi
query	string Obbligatorio. Una query i cui risultati vengono salvati.
lastRefreshTime	string (int64 format) Solo output. L'ora dell'ultimo aggiornamento di questa vista materializzata, in millisecondi dall'epoca.
enableRefresh	boolean Facoltativo. Attiva l'aggiornamento automatico della vista materializzata quando la tabella di base viene aggiornata. Il valore predefinito è "true".
refreshIntervalMs	string (UInt64Value format) Facoltativo. La frequenza massima con cui verrà aggiornata questa vista materializzata. Il valore predefinito è "1800000" (30 minuti).
allowNonIncrementalDefinition	boolean Facoltativo. Questa opzione dichiara l'intenzione di creare una vista materializzata che non viene aggiornata in modo incrementale. Le viste materializzate non incrementali supportano una gamma più ampia di query SQL. L'opzione allow_non_incremental_definition non può essere modificata dopo la creazione della vista materializzata.

Rappresentazione JSON
{ "refreshWatermark": string, "lastRefreshStatus": { object (ErrorProto) } }

Campi
refreshWatermark	string (Timestamp format) Solo output. Aggiorna il watermark della vista materializzata. I dati delle tabelle di base sono stati raccolti nella cache della vista materializzata fino a questo momento. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastRefreshStatus	object (ErrorProto) Solo output. Risultato dell'errore dell'ultimo aggiornamento automatico. Se presente, indica che l'ultimo aggiornamento automatico non è andato a buon fine.

Rappresentazione JSON
{ "seconds": string, "nanos": integer }

Campi
seconds	string (int64 format) Rappresenta i secondi di tempo UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos	integer Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

Rappresentazione JSON
{ "reason": string, "location": string, "debugInfo": string, "message": string }

Campi
reason	string Un breve codice di errore che riassume l'errore.
location	string Specifica dove si è verificato l'errore, se presente.
debugInfo	string Informazioni di debug. Questa proprietà è interna a Google e non deve essere utilizzata.
message	string Una descrizione dell'errore leggibile.

Rappresentazione 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. }

Campi
sourceUris[]	string [Obbligatorio] Gli URI completi che rimandano ai tuoi dati in Google Cloud. Per gli URI Google Cloud Storage: ogni URI può contenere un carattere jolly "*" e deve essere inserito dopo il nome del bucket. I limiti di dimensioni relativi ai job di caricamento si applicano alle origini dati esterne. Per gli URI Google Cloud Bigtable: può essere specificato un solo URI e deve essere un URL HTTPS valido e completamente specificato per una tabella Google Cloud Bigtable. Per i backup di Google Cloud Datastore, è possibile specificare esattamente un URI. Inoltre, il carattere jolly "*" non è consentito.
fileSetSpecType	enum (FileSetSpecType) Facoltativo. Specifica come vengono interpretati gli URI di origine per la creazione del set di file da caricare. Per impostazione predefinita, gli URI di origine vengono espansi rispetto allo spazio di archiviazione sottostante. Altre opzioni includono la specifica dei file manifest. Valido solo per i sistemi di archiviazione di oggetti.
schema	object (TableSchema) Facoltativo. Lo schema dei dati. Lo schema è obbligatorio per i formati CSV e JSON se il rilevamento automatico non è attivo. Lo schema non è consentito per i backup di Google Cloud Bigtable, Cloud Datastore, Avro, ORC e Parquet.
sourceFormat	string [Obbligatorio] Il formato dei dati. Per i file CSV, specifica "CSV". Per Fogli Google, specifica "GOOGLE_SHEETS". Per JSON delimitato da nuova riga, specifica "NEWLINE_DELIMITED_JSON". Per i file Avro, specifica "AVRO". Per i backup di Google Cloud Datastore, specifica "DATASTORE_BACKUP". Per le tabelle Apache Iceberg, specifica "ICEBERG". Per i file ORC, specifica "ORC". Per i file Parquet, specifica "PARQUET". [Beta] Per Google Cloud Bigtable, specifica "BIGTABLE".
maxBadRecords	integer Facoltativo. Il numero massimo di record non validi che BigQuery può ignorare durante la lettura dei dati. Se il numero di record non validi supera questo valore, nel risultato del job viene restituito un errore non valido. Il valore predefinito è 0, il che richiede che tutti i record siano validi. Questa impostazione viene ignorata per i backup di Google Cloud Bigtable, Google Cloud Datastore, Avro, ORC e Parquet.
autodetect	boolean Prova a rilevare automaticamente le opzioni di schema e formato. Qualsiasi opzione specificata esplicitamente verrà rispettata.
ignoreUnknownValues	boolean Facoltativo. Indica se BigQuery deve consentire valori aggiuntivi non rappresentati nello schema della tabella. Se il valore è vero, i valori extra vengono ignorati. Se il valore è false, i record con colonne aggiuntive vengono trattati come record non validi e, se sono troppi, nel risultato del job viene restituito un errore non valido. Il valore predefinito è false. La proprietà sourceFormat determina cosa BigQuery considera un valore aggiuntivo: CSV: colonne finali JSON: valori denominati che non corrispondono ad alcun nome di colonna Google Cloud Bigtable: questa impostazione viene ignorata. Backup di Google Cloud Datastore: questa impostazione viene ignorata. Avro: questa impostazione viene ignorata. ORC: questa impostazione viene ignorata. Parquet: questa impostazione viene ignorata.
compression	string Facoltativo. Il tipo di compressione dell'origine dati. I valori possibili includono GZIP e NONE. Il valore predefinito è NONE. Questa impostazione viene ignorata per i backup di Google Cloud Bigtable, Google Cloud Datastore, Avro, ORC e Parquet. Una stringa vuota è un valore non valido.
csvOptions	object (CsvOptions) Facoltativo. Proprietà aggiuntive da impostare se sourceFormat è impostato su CSV.
jsonOptions	object (JsonOptions) Facoltativo. Proprietà aggiuntive da impostare se sourceFormat è impostato su JSON.
bigtableOptions	object (BigtableOptions) Facoltativo. Opzioni aggiuntive se sourceFormat è impostato su BIGTABLE.
googleSheetsOptions	object (GoogleSheetsOptions) Facoltativo. Opzioni aggiuntive se sourceFormat è impostato su GOOGLE_SHEETS.
maxBadRecordsAlternative[]	integer Questo campo non deve essere utilizzato.
hivePartitioningOptions	object (HivePartitioningOptions) Facoltativo. Se impostato, configura il supporto del partizionamento Hive. Non tutti i formati di archiviazione supportano il partizionamento Hive. La richiesta di partizionamento Hive in un formato non supportato genera un errore, così come la fornitura di una specifica non valida.
connectionId	string Facoltativo. La connessione che specifica le credenziali da utilizzare per leggere l'archiviazione esterna, ad esempio Azure Blob, Cloud Storage o S3. connection_id può avere il formato {project_id}.{location_id};{connection_id} o projects/{project_id}/locations/{location_id}/connections/{connection_id}.
decimalTargetTypes[]	enum (DecimalTargetType) Definisce l'elenco dei possibili tipi di dati SQL in cui vengono convertiti i valori decimali di origine. Questo elenco e i parametri di precisione e scalabilità del campo decimale determinano il tipo di destinazione. Nell'ordine di NUMERIC, BIGNUMERIC e STRING, un tipo viene scelto se è nell'elenco specificato e se supporta la precisione e la scalabilità. STRING supporta tutti i valori di precisione e scalabilità. Se nessuno dei tipi elencati supporta la precisione e la scalabilità, viene scelto il tipo che supporta l'intervallo più ampio nell'elenco specificato e, se un valore supera l'intervallo supportato durante la lettura dei dati, viene generato un errore. Esempio: supponiamo che il valore di questo campo sia ["NUMERIC", "BIGNUMERIC"]. Se (precisione,scala) è: (38,9) -> NUMERIC; (39,9) -> BIGNUMERIC (NUMERIC non può contenere 30 cifre intere); (38,10) -> BIGNUMERIC (NUMERIC non può contenere 10 cifre frazionarie); (76,38) -> BIGNUMERIC; (77,38) -> BIGNUMERIC (errore se il valore supera l'intervallo supportato). Questo campo non può contenere tipi duplicati. L'ordine dei tipi in questo campo viene ignorato. Ad esempio, ["BIGNUMERIC", "NUMERIC"] è uguale a ["NUMERIC", "BIGNUMERIC"] e NUMERIC ha sempre la precedenza su BIGNUMERIC. Il valore predefinito è ["NUMERIC", "STRING"] per ORC e ["NUMERIC"] per gli altri formati file.
avroOptions	object (AvroOptions) Facoltativo. Proprietà aggiuntive da impostare se sourceFormat è impostato su AVRO.
jsonExtension	enum (JsonExtension) Facoltativo. Opzione di caricamento da utilizzare insieme a JSON delimitato da newline source_format per indicare che viene caricata una variante di JSON. Per caricare GeoJSON delimitato da nuova riga, specifica GEOJSON (e source_format deve essere impostato su NEWLINE_DELIMITED_JSON).
parquetOptions	object (ParquetOptions) Facoltativo. Proprietà aggiuntive da impostare se sourceFormat è impostato su PARQUET.
referenceFileSchemaUri	string Facoltativo. Quando crei una tabella esterna, l'utente può fornire un file di riferimento con lo schema della tabella. Questa opzione è abilitata per i seguenti formati: AVRO, PARQUET, ORC.
metadataCacheMode	enum (MetadataCacheMode) Facoltativo. Modalità cache metadati per la tabella. Imposta questa opzione per attivare la memorizzazione nella cache dei metadati dall'origine dati esterna.
timestampTargetPrecision[]	integer Precisioni (numero massimo di cifre totali in base 10) per i secondi dei tipi TIMESTAMP consentiti nella tabella di destinazione per la modalità di rilevamento automatico. Disponibile per i formati: CSV. Per il formato CSV, i valori possibili includono: Not Specified, [], o [6]: timestamp(6) per tutte le colonne TIMESTAMP rilevate automaticamente [6, 12]: timestamp(6) per tutte le colonne TIMESTAMP rilevate automaticamente con meno di 6 cifre di secondi. timestamp(12) per tutte le colonne TIMESTAMP rilevate automaticamente che hanno più di 6 cifre di secondi. [12]: timestamp(12) per tutte le colonne TIMESTAMP rilevate automaticamente. L'ordine degli elementi in questo array viene ignorato. Gli input con una precisione superiore a quella del target più elevato in questo array verranno troncati.
Campo unione _object_metadata. _object_metadata può essere solo uno dei seguenti tipi:
objectMetadata	enum (ObjectMetadata) Facoltativo. ObjectMetadata viene utilizzato per creare tabelle di oggetti. Le tabelle degli oggetti contengono un elenco di oggetti (con i relativi metadati) trovati in source_uris. Se ObjectMetadata è impostato, source_format deve essere omesso. Al momento, SIMPLE è l'unico tipo di metadati dell'oggetto supportato.
Campo unione _time_zone. _time_zone può essere solo uno dei seguenti tipi:
timeZone	string Facoltativo. Fuso orario utilizzato durante l'analisi dei valori timestamp che non hanno informazioni specifiche sul fuso orario (ad es. 2024-04-20 12:34:56). Il formato previsto è una stringa del fuso orario IANA (ad es. America/Los_Angeles).
Campo unione _date_format. _date_format può essere solo uno dei seguenti tipi:
dateFormat	string Facoltativo. Formato utilizzato per analizzare i valori DATE. Supporta valori in stile C e SQL.
Campo unione _datetime_format. _datetime_format può essere solo uno dei seguenti tipi:
datetimeFormat	string Facoltativo. Formato utilizzato per analizzare i valori DATETIME. Supporta valori in stile C e SQL.
Campo unione _time_format. _time_format può essere solo uno dei seguenti tipi:
timeFormat	string Facoltativo. Formato utilizzato per analizzare i valori TIME. Supporta valori in stile C e SQL.
Campo unione _timestamp_format. _timestamp_format può essere solo uno dei seguenti tipi:
timestampFormat	string Facoltativo. Formato utilizzato per analizzare i valori TIMESTAMP. Supporta valori in stile C e SQL.

Rappresentazione JSON
{ "value": integer }

Campi
value	integer Il valore int32.

Rappresentazione JSON
{ "fieldDelimiter": string, "skipLeadingRows": string, "quote": string, "allowQuotedNewlines": boolean, "allowJaggedRows": boolean, "encoding": string, "preserveAsciiControlCharacters": boolean, "nullMarker": string, "nullMarkers": [ string ], "sourceColumnMatch": string }

Campi
fieldDelimiter	string Facoltativo. Il carattere separatore per i campi in un file CSV. Il separatore viene interpretato come un singolo byte. Per i file codificati in ISO-8859-1, è possibile utilizzare qualsiasi carattere singolo come separatore. Per i file codificati in UTF-8, i caratteri rappresentati nell'intervallo decimale 1-127 (U+0001-U+007F) possono essere utilizzati senza modifiche. Per i caratteri UTF-8 codificati con più byte (ad es. U+0080 e superiori), verrà utilizzato solo il primo byte per separare i campi. I byte rimanenti verranno trattati come parte del campo. BigQuery supporta anche la sequenza di escape "\t" (U+0009) per specificare un separatore di tabulazione. Il valore predefinito è la virgola (",", U+002C).
skipLeadingRows	string (Int64Value format) Facoltativo. Il numero di righe nella parte superiore di un file CSV che BigQuery salterà durante la lettura dei dati. Il valore predefinito è 0. Questa proprietà è utile se nel file sono presenti righe di intestazione da ignorare. Quando il rilevamento automatico è attivo, il comportamento è il seguente: skipLeadingRows non specificato: il rilevamento automatico tenta di rilevare le intestazioni nella prima riga. Se non vengono rilevati, la riga viene letta come dati. In caso contrario, i dati vengono letti a partire dalla seconda riga. skipLeadingRows è 0: indica il rilevamento automatico che non sono presenti intestazioni e che i dati devono essere letti a partire dalla prima riga. skipLeadingRows = N > 0: il rilevamento automatico salta N-1 righe e tenta di rilevare le intestazioni nella riga N. Se le intestazioni non vengono rilevate, la riga N viene semplicemente ignorata. In caso contrario, la riga N viene utilizzata per estrarre i nomi delle colonne per lo schema rilevato.
quote	string Facoltativo. Il valore utilizzato per citare le sezioni di dati in un file CSV. BigQuery converte la stringa nella codifica ISO-8859-1, quindi utilizza il primo byte della stringa codificata per dividere i dati nel loro stato binario non elaborato. Il valore predefinito è una virgoletta doppia ("). Se i dati non contengono sezioni tra virgolette, imposta il valore della proprietà su una stringa vuota. Se i tuoi dati contengono caratteri di nuova riga tra virgolette, devi impostare la proprietà allowQuotedNewlines su true. Per includere il carattere virgolette specifico all'interno di un valore tra virgolette, anteponi un carattere virgolette corrispondente aggiuntivo. Ad esempio, se vuoi eseguire l'escape del carattere predefinito " " ", utilizza " "" ".
allowQuotedNewlines	boolean Facoltativo. Indica se BigQuery deve consentire sezioni di dati tra virgolette che contengono caratteri di nuova riga in un file CSV. Il valore predefinito è false.
allowJaggedRows	boolean Facoltativo. Indica se BigQuery deve accettare le righe a cui mancano le colonne opzionali finali. Se è true, BigQuery considera le colonne finali mancanti come valori null. Se è false, i record con colonne finali mancanti vengono trattati come record non validi e, se sono presenti troppi record non validi, nel risultato del job viene restituito un errore non valido. Il valore predefinito è false.
encoding	string Facoltativo. La codifica dei caratteri dei dati. I valori supportati sono UTF-8, ISO-8859-1, UTF-16BE, UTF-16LE, UTF-32BE e UTF-32LE. Il valore predefinito è UTF-8. BigQuery decodifica i dati dopo che i dati binari non elaborati sono stati suddivisi utilizzando i valori delle proprietà quote e fieldDelimiter.
preserveAsciiControlCharacters	boolean Facoltativo. Indica se i caratteri di controllo ASCII incorporati (i primi 32 caratteri della tabella ASCII, da "\x00" a "\x1F") vengono conservati.
nullMarker	string Facoltativo. Specifica una stringa che rappresenta un valore nullo in un file CSV. Ad esempio, se specifichi "\N", BigQuery interpreta "\N" come valore nullo quando esegui una query su un file CSV. Il valore predefinito è la stringa vuota. Se imposti questa proprietà su un valore personalizzato, BigQuery genera un errore se è presente una stringa vuota per tutti i tipi di dati, ad eccezione di STRING e BYTE. Per le colonne STRING e BYTE, BigQuery interpreta la stringa vuota come un valore vuoto.
nullMarkers[]	string Facoltativo. Un elenco di stringhe rappresentate come valore SQL NULL in un file CSV. null_marker e null_markers non possono essere impostati contemporaneamente. Se null_marker è impostato, null_markers non deve essere impostato. Se null_markers è impostato, null_marker non deve essere impostato. Se null_marker e null_markers sono impostati contemporaneamente, verrà generato un errore utente. Qualsiasi stringa elencata in null_markers, inclusa la stringa vuota, verrà interpretata come SQL NULL. Questo vale per tutti i tipi di colonne.
sourceColumnMatch	string Facoltativo. Controlla la strategia utilizzata per abbinare le colonne caricate allo schema. Se non viene impostato, viene scelto un valore predefinito ragionevole in base alla modalità di fornitura dello schema. Se viene utilizzato il rilevamento automatico, le colonne vengono abbinate in base al nome. In caso contrario, le colonne vengono abbinate in base alla posizione. Questa operazione viene eseguita per mantenere la compatibilità con le versioni precedenti. I valori accettabili sono: POSITION (POSIZIONE) - corrisponde alla posizione. Ciò presuppone che le colonne siano ordinate nello stesso modo dello schema. NAME - corrispondenza in base al nome. In questo modo, la riga di intestazione viene letta come nomi delle colonne e le colonne vengono riordinate in modo che corrispondano ai nomi dei campi nello schema.

Rappresentazione JSON
{ "encoding": string }

Campi
encoding	string Facoltativo. La codifica dei caratteri dei dati. I valori supportati sono UTF-8, UTF-16BE, UTF-16LE, UTF-32BE e UTF-32LE. Il valore predefinito è UTF-8.

Rappresentazione JSON
{ "columnFamilies": [ { object (BigtableColumnFamily) } ], "ignoreUnspecifiedColumnFamilies": boolean, "readRowkeyAsString": boolean, "outputColumnFamiliesAsJson": boolean }

Campi
columnFamilies[]	object (BigtableColumnFamily) Facoltativo. Elenco delle famiglie di colonne da esporre nello schema della tabella insieme ai relativi tipi. Questo elenco limita le famiglie di colonne a cui è possibile fare riferimento nelle query e specifica i relativi tipi di valori. Puoi utilizzare questo elenco per eseguire conversioni di tipo. Per maggiori dettagli, consulta il campo "Tipo". Se lasci questo elenco vuoto, tutte le famiglie di colonne sono presenti nello schema della tabella e i relativi valori vengono letti come BYTES. Durante una query, da Bigtable vengono lette solo le famiglie di colonne a cui viene fatto riferimento nella query.
ignoreUnspecifiedColumnFamilies	boolean Facoltativo. Se il campo è true, le famiglie di colonne non specificate nell'elenco columnFamilies non vengono esposte nello schema della tabella. In caso contrario, vengono letti con valori di tipo BYTES. Il valore predefinito è false.
readRowkeyAsString	boolean Facoltativo. Se il campo è true, le famiglie di colonne rowkey verranno lette e convertite in stringhe. In caso contrario, vengono letti con valori di tipo BYTES e gli utenti devono eseguirne manualmente il cast con CAST, se necessario. Il valore predefinito è false.
outputColumnFamiliesAsJson	boolean Facoltativo. Se il campo è true, ogni famiglia di colonne verrà letta come una singola colonna JSON. In caso contrario, vengono letti come una struttura di celle ripetuta contenente tuple timestamp/valore. Il valore predefinito è false.

Rappresentazione JSON
{ "familyId": string, "type": string, "encoding": string, "columns": [ { object (BigtableColumn) } ], "onlyReadLatest": boolean, "protoConfig": { object (BigtableProtoConfig) } }

Campi
familyId	string Identificatore della famiglia di colonne.
type	string Facoltativo. Il tipo in cui convertire il valore nelle celle di questa famiglia di colonne. Quando si utilizza il valore di codifica BINARY, è previsto che i valori vengano codificati utilizzando la funzione HBase Bytes.toBytes. Sono consentiti i seguenti tipi BigQuery (distinguono tra maiuscole e minuscole): BYTES STRING INTEGER FLOAT BOOLEANO JSON Il tipo predefinito è BYTES. Questa impostazione può essere sovrascritta per una colonna specifica elencandola in "columns" e specificando un tipo.
encoding	string Facoltativo. La codifica dei valori quando il tipo non è STRING. I valori di codifica accettabili sono: TEXT: indica che i valori sono stringhe di testo alfanumeriche. BINARY: indica che i valori sono codificati utilizzando la famiglia di funzioni Bytes.toBytes di HBase. PROTO_BINARY: indica che i valori sono codificati utilizzando messaggi proto serializzati. Può essere utilizzato solo in combinazione con il tipo JSON. Questa impostazione può essere sovrascritta per una colonna specifica elencandola in "colonne" e specificando una codifica.
columns[]	object (BigtableColumn) Facoltativo. Elenchi di colonne che devono essere esposte come singoli campi anziché come un elenco di coppie (nome colonna, valore). È possibile accedere a tutte le colonne il cui qualificatore corrisponde a un qualificatore di questo elenco come <family field name>.<column field name>. È possibile accedere ad altre colonne come elenco tramite il campo <family field name>.Column.
onlyReadLatest	boolean Facoltativo. Se questa opzione è impostata, viene esposta solo l'ultima versione del valore per tutte le colonne di questa famiglia di colonne. Questa impostazione può essere sovrascritta per una colonna specifica elencandola in "colonne" e specificando un'impostazione diversa per quella colonna.
protoConfig	object (BigtableProtoConfig) Facoltativo. Configurazioni specifiche di Protobuf, che hanno effetto solo quando la codifica è PROTO_BINARY.

Rappresentazione JSON
{ "qualifierEncoded": string, "qualifierString": string, "fieldName": string, "type": string, "encoding": string, "onlyReadLatest": boolean, "protoConfig": { object (BigtableProtoConfig) } }

Campi
qualifierEncoded	string (BytesValue format) [Obbligatorio] Qualificatore della colonna. Le colonne della famiglia di colonne principale che hanno questo qualificatore esatto vengono esposte come campo <family field name>.<column field name>. Se il qualificatore è una stringa UTF-8 valida, può essere specificato nel campo qualifier_string. In caso contrario, un valore codificato in base-64 deve essere impostato su qualifier_encoded. Il nome del campo della colonna è uguale al qualificatore di colonna. Tuttavia, se il qualificatore non è un identificatore di campo BigQuery valido, ovvero non corrisponde a [a-zA-Z][a-zA-Z0-9_]*, deve essere fornito un identificatore valido come field_name.
qualifierString	string Stringa qualificatore.
fieldName	string Facoltativo. Se il qualificatore non è un identificatore di campo BigQuery valido, ovvero non corrisponde a [a-zA-Z][a-zA-Z0-9_]*, deve essere fornito un identificatore valido come nome del campo colonna e viene utilizzato come nome del campo nelle query.
type	string Facoltativo. Il tipo in cui convertire il valore nelle celle di questa colonna. Quando si utilizza il valore di codifica BINARY, è previsto che i valori vengano codificati utilizzando la funzione HBase Bytes.toBytes. Sono consentiti i seguenti tipi BigQuery (distinguono tra maiuscole e minuscole): BYTES STRING INTEGER FLOAT BOOLEANO JSON Il tipo predefinito è BYTES. "type" può essere impostato anche a livello di famiglia di colonne. Tuttavia, l'impostazione a questo livello ha la precedenza se il "tipo" è impostato a entrambi i livelli.
encoding	string Facoltativo. La codifica dei valori quando il tipo non è STRING. I valori di codifica accettabili sono: TEXT: indica che i valori sono stringhe di testo alfanumeriche. BINARY: indica che i valori sono codificati utilizzando la famiglia di funzioni Bytes.toBytes di HBase. PROTO_BINARY: indica che i valori sono codificati utilizzando messaggi proto serializzati. Può essere utilizzato solo in combinazione con il tipo JSON. "encoding" può essere impostato anche a livello di famiglia di colonne. Tuttavia, l'impostazione a questo livello ha la precedenza se "encoding" è impostato a entrambi i livelli.
onlyReadLatest	boolean Facoltativo. Se questo valore è impostato, viene esposta solo l'ultima versione del valore in questa colonna. "onlyReadLatest" può essere impostato anche a livello di famiglia di colonne. Tuttavia, l'impostazione a questo livello ha la precedenza se "onlyReadLatest" è impostato a entrambi i livelli.
protoConfig	object (BigtableProtoConfig) Facoltativo. Configurazioni specifiche di Protobuf, che hanno effetto solo quando la codifica è PROTO_BINARY.

Rappresentazione JSON
{ "value": string }

Campi
value	string (bytes format) Il valore dei byte. Una stringa con codifica Base64.

Rappresentazione JSON
{ "schemaBundleId": string, "protoMessageName": string }

Campi
schemaBundleId	string Facoltativo. L'ID della risorsa Bigtable SchemaBundle associata a questo protobuf. L'ID deve essere indicato all'interno della tabella principale, ad esempio: foo anziché projects/{project}/instances/{instance}/tables/{table}/schemaBundles/foo. Scopri maggiori dettagli sui Bigtable SchemaBundles.
protoMessageName	string Facoltativo. Il nome del messaggio proto completo del protobuf. Nel formato "foo.bar.Message".

Rappresentazione JSON
{ "skipLeadingRows": string, "range": string }

Campi
skipLeadingRows	string (Int64Value format) Facoltativo. Il numero di righe nella parte superiore di un foglio che BigQuery ignorerà durante la lettura dei dati. Il valore predefinito è 0. Questa proprietà è utile se sono presenti righe di intestazione da ignorare. Quando il rilevamento automatico è attivo, il comportamento è il seguente: * skipLeadingRows non specificato: il rilevamento automatico tenta di rilevare le intestazioni nella prima riga. Se non vengono rilevati, la riga viene letta come dati. In caso contrario, i dati vengono letti a partire dalla seconda riga. * skipLeadingRows è 0: indica il rilevamento automatico che non sono presenti intestazioni e che i dati devono essere letti a partire dalla prima riga. * skipLeadingRows = N > 0 - Il rilevamento automatico salta N-1 righe e tenta di rilevare le intestazioni nella riga N. Se le intestazioni non vengono rilevate, la riga N viene semplicemente ignorata. In caso contrario, la riga N viene utilizzata per estrarre i nomi delle colonne per lo schema rilevato.
range	string Facoltativo. Intervallo di un foglio da cui eseguire la query. Utilizzato solo se non è vuoto. Formato tipico: nome_foglio!id_cella_in_alto_a_sinistra:id_cella_in_basso_a_destra. Ad esempio: foglio1!A1:B20

Rappresentazione JSON
{ "mode": string, "sourceUriPrefix": string, "requirePartitionFilter": boolean, "fields": [ string ] }

Campi
mode	string Facoltativo. Se impostato, la modalità di partizionamento Hive da utilizzare durante la lettura dei dati. Sono supportate le seguenti modalità: AUTO: deduce automaticamente i nomi e i tipi delle chiavi di partizione. STRINGHE: deduce automaticamente i nomi delle chiavi di partizione. Tutti i tipi sono stringhe. CUSTOM: lo schema della chiave di partizionamento è codificato nel prefisso URI di origine. Non tutti i formati di archiviazione supportano il partizionamento Hive. La richiesta di partizionamento Hive in un formato non supportato genererà un errore. I formati attualmente supportati sono: JSON, CSV, ORC, Avro e Parquet.
sourceUriPrefix	string Facoltativo. Quando viene richiesta la rilevazione delle partizioni Hive, è necessario un prefisso comune per tutti gli URI di origine. Il prefisso deve terminare immediatamente prima dell'inizio della codifica della chiave di partizione. Ad esempio, considera i file che seguono questo layout dei dati: 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 Quando viene richiesto il partizionamento Hive con il rilevamento AUTO o STRINGS, il prefisso comune può essere gs://bucket/path_to_table o gs://bucket/path_to_table/. Il rilevamento CUSTOM richiede la codifica dello schema di partizionamento immediatamente dopo il prefisso comune. Per CUSTOM, uno qualsiasi dei seguenti 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} sarebbero tutti prefissi URI di origine validi.
requirePartitionFilter	boolean Facoltativo. Se impostato su true, le query su questa tabella richiedono la specifica di un filtro di partizionamento che può essere utilizzato per l'eliminazione della partizione. Tieni presente che questo campo deve essere true solo quando crei una tabella esterna permanente o esegui una query su una tabella esterna temporanea. I caricamenti partizionati in Hive con require_partition_filter impostato esplicitamente su true non andranno a buon fine.
fields[]	string Solo output. Per le tabelle esterne permanenti, questo campo viene compilato con le chiavi di partizione Hive nell'ordine in cui sono state dedotte. I tipi di chiavi di partizione possono essere dedotti controllando lo schema della tabella (che includerà le chiavi di partizione). Non tutte le API compilano questo campo nell'output. Ad esempio, Tables.Get lo compilerà, ma Tables.List non conterrà questo campo.

Rappresentazione JSON
{ "useAvroLogicalTypes": boolean }

Campi
useAvroLogicalTypes	boolean Facoltativo. Se sourceFormat è impostato su "AVRO", indica se interpretare i tipi logici come il tipo di dati BigQuery corrispondente (ad esempio TIMESTAMP), anziché utilizzare il tipo non elaborato (ad esempio INTEGER).

Rappresentazione JSON
{ "enumAsString": boolean, "enableListInference": boolean, "mapTargetType": enum (MapTargetType) }

Campi
enumAsString	boolean Facoltativo. Indica se dedurre il tipo logico ENUM Parquet come STRING anziché BYTES per impostazione predefinita.
enableListInference	boolean Facoltativo. Indica se utilizzare l'inferenza dello schema specificamente per il tipo logico LIST di Parquet.
mapTargetType	enum (MapTargetType) Facoltativo. Indica come rappresentare una mappa Parquet, se presente.

Rappresentazione JSON
{ "connectionId": string, "storageUri": string, "fileFormat": enum (FileFormat), "tableFormat": enum (TableFormat) }

Campi
connectionId	string Facoltativo. La connessione che specifica le credenziali da utilizzare per leggere e scrivere nell'archiviazione esterna, ad esempio Cloud Storage. connection_id può avere il formato {project}.{location}.{connection_id} o "projects/{project}/locations/{location}/connections/{connection_id}".
storageUri	string Facoltativo. Il prefisso della posizione completa della cartella esterna in cui sono archiviati i dati della tabella. Il carattere jolly "*" non è consentito. L'URI deve essere nel formato gs://bucket/path_to_table/
fileFormat	enum (FileFormat) Facoltativo. Il formato del file in cui sono archiviati i dati della tabella.
tableFormat	enum (TableFormat) Facoltativo. Il formato della tabella in cui vengono archiviati gli snapshot solo dei metadati.

Rappresentazione JSON
{ "estimatedBytes": string, "estimatedRows": string, "oldestEntryTime": string }

Campi
estimatedBytes	string Solo output. Una stima del limite inferiore del numero di byte attualmente presenti nel buffer di streaming.
estimatedRows	string Solo output. Una stima del limite inferiore del numero di righe attualmente nel buffer di streaming.
oldestEntryTime	string (uint64 format) Solo output. Contiene il timestamp della voce meno recente nel buffer dei flussi di dati, in millisecondi dall'epoca, se il buffer dei flussi di dati è disponibile.

Rappresentazione JSON
{ "kmsKeyName": string }

Campi
kmsKeyName	string Facoltativo. Descrive la chiave di crittografia Cloud KMS che verrà utilizzata per proteggere la tabella BigQuery di destinazione. Il service account BigQuery associato al tuo progetto richiede l'accesso a questa chiave di crittografia.

Rappresentazione JSON
{ "baseTableReference": { object (TableReference) }, "snapshotTime": string }

Campi
baseTableReference	object (TableReference) Obbligatorio. Riferimento che descrive l'ID della tabella di cui è stato creato lo snapshot.
snapshotTime	string (Timestamp format) Obbligatorio. L'ora in cui è stato creato lo snapshot della tabella di base. Questo valore viene riportato nella risposta JSON utilizzando il formato RFC3339. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Rappresentazione JSON
{ "baseTableReference": { object (TableReference) }, "cloneTime": string }

Campi
baseTableReference	object (TableReference) Obbligatorio. Riferimento che descrive l'ID della tabella clonata.
cloneTime	string (Timestamp format) Obbligatorio. L'ora in cui è stata clonata la tabella di base. Questo valore viene riportato nella risposta JSON utilizzando il formato RFC3339. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Rappresentazione JSON
{ "type": enum (RestrictionType) }

Campi
type	enum (RestrictionType) Solo output. Specifica il tipo di limitazione del set di dati/della tabella.

Rappresentazione JSON
{ "primaryKey": { object (PrimaryKey) }, "foreignKeys": [ { object (ForeignKey) } ] }

Campi
primaryKey	object (PrimaryKey) Facoltativo. Rappresenta un vincolo di chiave primaria sulle colonne di una tabella. Presente solo se la tabella ha una chiave primaria. La chiave primaria non viene applicata.
foreignKeys[]	object (ForeignKey) Facoltativo. Presente solo se la tabella ha una chiave esterna. La chiave esterna non viene applicata.

Rappresentazione JSON
{ "columns": [ string ] }

Campi
columns[]	string Obbligatorio. Le colonne che compongono il vincolo di chiave primaria.

Rappresentazione JSON
{ "name": string, "referencedTable": { object (TableReference) }, "columnReferences": [ { object (ColumnReference) } ] }

Campi
name	string Facoltativo. Imposta solo se il vincolo di chiave esterna è denominato.
referencedTable	object (TableReference) Obbligatorio. La tabella che contiene la chiave primaria e a cui fa riferimento questa chiave esterna.
columnReferences[]	object (ColumnReference) Obbligatorio. Le colonne che compongono la chiave esterna.

Rappresentazione JSON
{ "referencingColumn": string, "referencedColumn": string }

Campi
referencingColumn	string Obbligatorio. La colonna che compone la chiave esterna.
referencedColumn	string Obbligatorio. La colonna della chiave primaria a cui fa riferimento referencing_column.

Rappresentazione JSON
{ "key": string, "value": string }

Campi
key	string
value	string

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

Campi
sourceTable	object (TableReference) Obbligatorio. Riferimento alla tabella di origine replicata.
replicationIntervalMs	string (int64 format) Facoltativo. Specifica l'intervallo in cui viene eseguito il polling della tabella di origine per gli aggiornamenti. È facoltativo. Se non specificato, verrà applicato l'intervallo di replica predefinito.
replicatedSourceLastRefreshTime	string (int64 format) Facoltativo. Solo output. Se l'origine è una vista materializzata, questo campo indica l'ultimo aggiornamento dell'origine.
replicationStatus	enum (ReplicationStatus) Facoltativo. Solo output. Stato della replica configurata.
replicationError	object (ErrorProto) Facoltativo. Solo output. Errore di replica che interromperà definitivamente la replica della tabella.

Rappresentazione JSON
{ "parameters": { string: string, ... }, "storageDescriptor": { object (StorageDescriptor) }, "connectionId": string }

Campi
parameters	map (key: string, value: string) Facoltativo. Una mappa delle coppie chiave-valore che definiscono i parametri e le proprietà della tabella open source. Corrisponde ai parametri della tabella del metastore Hive. Dimensione massima di 4 MiB. Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
storageDescriptor	object (StorageDescriptor) Facoltativo. Un descrittore di archiviazione contenente informazioni sull'archiviazione fisica di questa tabella.
connectionId	string Facoltativo. Un ID connessione che specifica le credenziali da utilizzare per leggere lo spazio di archiviazione esterno, ad esempio Azure Blob, Cloud Storage o Amazon S3. Questa connessione è necessaria per leggere la tabella open source da BigQuery. Il formato di connection_id deve essere <project_id>.<location_id>.<connection_id> o projects/<project_id>/locations/<location_id>/connections/<connection_id>.

Rappresentazione JSON
{ "key": string, "value": string }

Campi
key	string
value	string

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

Campi
locationUri	string Facoltativo. La posizione fisica della tabella (ad es. gs://spark-dataproc-data/pangea-data/case_sensitive/ o gs://spark-dataproc-data/pangea-data/*). La lunghezza massima è di 2056 byte.
inputFormat	string Facoltativo. Specifica il nome di classe completo di InputFormat (ad es. "org.apache.hadoop.hive.ql.io.orc.OrcInputFormat"). La lunghezza massima è di 128 caratteri.
outputFormat	string Facoltativo. Specifica il nome di classe completo di OutputFormat (ad es. "org.apache.hadoop.hive.ql.io.orc.OrcOutputFormat"). La lunghezza massima è di 128 caratteri.
serdeInfo	object (SerDeInfo) Facoltativo. Informazioni su serializzatore e deserializzatore.

Rappresentazione JSON
{ "name": string, "serializationLibrary": string, "parameters": { string: string, ... } }

Campi
name	string Facoltativo. Nome di SerDe. La lunghezza massima è di 256 caratteri.
serializationLibrary	string Obbligatorio. Specifica il nome di classe completo della libreria di serializzazione responsabile della conversione dei dati tra la rappresentazione della tabella e le strutture di formato di input e output di basso livello sottostanti. La lunghezza massima è di 256 caratteri.
parameters	map (key: string, value: string) Facoltativo. Coppie chiave-valore che definiscono i parametri di inizializzazione per la libreria di serializzazione. Dimensione massima 10 KiB. Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Rappresentazione JSON
{ "key": string, "value": string }

Campi
key	string
value	string

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌