MCP Tools Reference: bigquery.googleapis.com

Tool: get_dataset_info

Metadaten zu einem BigQuery-Dataset abrufen

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool get_dataset_info aufrufen.

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

Eingabeschema

Anfrage für ein Dataset.

JSON-Darstellung 
{
  "projectId": string,
  "datasetId": string
}
Felder
projectId

string

Erforderlich. Projekt-ID der Dataset-Anfrage.
datasetId

string

Erforderlich. Dataset-ID der Dataset-Anfrage.

Ausgabeschema

Stellt ein BigQuery-Dataset dar.

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

string

Nur Ausgabe. Der Ressourcentyp.
etag

string

Nur Ausgabe. Ein Hash der Ressource.
id

string

Nur Ausgabe. Der vollständig qualifizierte eindeutige Name des Datasets im Format „projectId:datasetId“. Der Dataset-Name ohne den Projektnamen wird im Feld „datasetId“ angegeben. Wenn Sie ein neues Dataset erstellen, lassen Sie dieses Feld leer und geben Sie stattdessen das Feld „datasetId“ an.
selfLink

string

Nur Ausgabe. Eine URL, über die wieder auf die Ressource zugegriffen werden kann. Sie können diese URL in Get- oder Update-Anfragen an die Ressource verwenden.
datasetReference

object (DatasetReference)

Erforderlich. Eine Referenz, die den Datensatz identifiziert.
friendlyName

string

Optional. Ein aussagekräftiger Name für das Dataset.
description

string

Optional. Eine nutzerfreundliche Beschreibung des Datasets.
defaultTableExpirationMs

string (Int64Value format)

Optional. Die Standardlebensdauer aller Tabellen im Dataset in Millisekunden. Der Mindestwert für die Lebensdauer beträgt 3.600.000 Millisekunden (eine Stunde). Wenn Sie ein vorhandenes Standardablaufdatum mit einer PATCH-Anfrage löschen möchten, setzen Sie den Wert auf 0. Sobald diese Property festgelegt ist, haben alle neu erstellten Tabellen im Dataset eine „expirationTime“-Property, die auf die Erstellungszeit plus den Wert in dieser Property festgelegt ist. Eine Änderung des Werts wirkt sich nur auf neue Tabellen aus, nicht auf vorhandene. Wenn die expirationTime für eine bestimmte Tabelle erreicht ist, wird diese Tabelle automatisch gelöscht. Wenn die expirationTime einer Tabelle vor dem Ablauf der Tabelle geändert oder entfernt wird oder wenn Sie beim Erstellen einer Tabelle eine explizite expirationTime angeben, hat dieser Wert Vorrang vor der durch diese Eigenschaft angegebenen Standardablaufzeit.
defaultPartitionExpirationMs

string (Int64Value format)

Diese Standardablaufzeit für Partitionen wird in Millisekunden angegeben.

Wenn in einem Dataset, in dem diese Eigenschaft festgelegt ist, neue nach Zeit partitionierte Tabellen erstellt werden, wird dieser Wert für die Tabelle übernommen und als TimePartitioning.expirationMs-Eigenschaft für die neue Tabelle weitergegeben. Wenn Sie TimePartitioning.expirationMs beim Erstellen einer Tabelle explizit festlegen, wird die defaultPartitionExpirationMs des enthaltenden Datasets ignoriert.

Wenn Sie eine partitionierte Tabelle erstellen und defaultPartitionExpirationMs festgelegt ist, wird der Wert defaultTableExpirationMs ignoriert und die Tabelle erbt keine Ablaufzeit.
labels

map (key: string, value: string)

Die mit diesem Datensatz verknüpften Labels. Damit können Sie Ihre Datasets organisieren und gruppieren. Sie können diese Eigenschaft beim Einfügen oder Aktualisieren eines Datasets festlegen. Weitere Informationen finden Sie unter Dataset-Labels erstellen und aktualisieren.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
access[]

object (Access)

Optional. Ein Array von Objekten, die den Dataset-Zugriff für eine oder mehrere Entitäten definieren. Sie können diese Property beim Einfügen oder Aktualisieren eines Datasets festlegen, um zu steuern, wer auf die Daten zugreifen darf. Wenn beim Erstellen des Datasets nichts angegeben wird, fügt BigQuery Standard-Dataset-Zugriff für die folgenden Entitäten hinzu: access.specialGroup: projectReaders; access.role: READER; access.specialGroup: projectWriters; access.role: WRITER; access.specialGroup: projectOwners; access.role: OWNER; access.userByEmail: [E-Mail-Adresse des Dataset-Erstellers]; access.role: OWNER; Wenn Sie ein Dataset patchen, wird dieses Feld durch das Zugriffsfeld des gepatchten Datasets überschrieben. Wenn Sie Entitäten hinzufügen möchten, müssen Sie das gesamte vorhandene Zugriffs-Array sowie alle neuen Entitäten angeben, die Sie hinzufügen möchten.
creationTime

string (int64 format)

Nur Ausgabe. Der Zeitpunkt, zu dem dieses Dataset erstellt wurde, in Millisekunden seit der Epoche.
lastModifiedTime

string (int64 format)

Nur Ausgabe. Das Datum der letzten Änderung an diesem Dataset in Millisekunden seit der Epoche.
location

string

Der geografische Standort, an dem sich das Dataset befinden soll. Unterstützte Standorte finden Sie unter https://cloud.google.com/bigquery/docs/locations.
defaultEncryptionConfiguration

object (EncryptionConfiguration)

Der Standardschlüssel für die Verschlüsselung aller Tabellen im Dataset. Nachdem diese Property festgelegt wurde, wird der Verschlüsselungsschlüssel aller neu erstellten Tabellen im Dataset auf diesen Wert gesetzt, sofern der Schlüssel nicht explizit durch die Anfrage oder Abfrage zum Erstellen der Tabelle überschrieben wird.
satisfiesPzs

boolean

Nur Ausgabe. Reserviert für zukünftige Verwendungen.
satisfiesPzi

boolean

Nur Ausgabe. Reserviert für zukünftige Verwendungen.
type

string

Nur Ausgabe. Gleiche wie type in ListFormatDataset. Der Typ des Datasets, einer der folgenden:

  • STANDARD: Nur für Inhaber und autorisierte Konten zugänglich.
  • ÖFFENTLICH: Für alle zugänglich
  • LINKED: verknüpftes Dataset
  • EXTERNAL: Dataset mit Definition in einem externen Metadatenkatalog.
linkedDatasetSource

object (LinkedDatasetSource)

Optional. Die Referenz auf den Quelldatensatz, wenn der Datensatz vom Typ LINKED ist. Für alle anderen Datensatztypen ist sie nicht festgelegt. Dieses Feld kann nach dem Festlegen nicht mehr aktualisiert werden. Jeder Versuch, dieses Feld mit den API-Vorgängen „Update“ und „Patch“ zu aktualisieren, wird ignoriert.
linkedDatasetMetadata

object (LinkedDatasetMetadata)

Nur Ausgabe. Metadaten zum LinkedDataset. Wird ausgefüllt, wenn der Dataset-Typ LINKED ist.
externalDatasetReference

object (ExternalDatasetReference)

Optional. Verweis auf ein schreibgeschütztes externes Dataset, das in Datenkatalogen außerhalb von BigQuery definiert ist. Wird ausgefüllt, wenn der Dataset-Typ EXTERNAL ist.
externalCatalogDatasetOptions

object (ExternalCatalogDatasetOptions)

Optional. Optionen zum Definieren von Open-Source-kompatiblen Datasets im BigQuery-Katalog. Enthält Metadaten der Open-Source-Datenbank, des Schemas oder des Namespace, die durch das aktuelle Dataset dargestellt werden.
isCaseInsensitive

boolean

Optional. TRUE, wenn bei den Dataset- und Tabellennamen die Groß-/Kleinschreibung nicht berücksichtigt wird, andernfalls FALSE. Standardmäßig ist dieser Wert auf FALSE festgelegt. Das bedeutet, dass bei den Dataset- und Tabellennamen die Groß-/Kleinschreibung berücksichtigt wird. Dieses Feld hat keine Auswirkungen auf Routineverweise.
defaultCollation

string

Optional. Definiert die Standardsortierspezifikation für zukünftige Tabellen, die im Dataset erstellt werden. Wenn in diesem Dataset eine Tabelle ohne Standard-Sortierung auf Tabellenebene erstellt wird, übernimmt die Tabelle die Standard-Sortierung des Datasets, die auf die Stringfelder angewendet wird, für die keine explizite Sortierung angegeben ist. Eine Änderung an diesem Feld wirkt sich nur auf Tabellen aus, die danach erstellt werden. Vorhandene Tabellen werden nicht geändert. Folgende Werte werden unterstützt:

  • 'und:ci': unbestimmtes Gebietsschema, Groß-/Kleinschreibung nicht berücksichtigend.
  • '': leerer String. Standardmäßig wird zwischen Groß- und Kleinschreibung unterschieden.
defaultRoundingMode

enum (RoundingMode)

Optional. Definiert den Standardrundungsmodus für neue Tabellen, die in diesem Dataset erstellt werden. Wenn dieses Feld beim Erstellen der Tabelle angegeben wird, übernimmt die Tabelle in diesem Dataset den Standardrundungsmodus des Datasets. Durch das Festlegen des Standard-Rundungsmodus für eine Tabelle wird diese Option überschrieben. Vorhandene Tabellen im Datensatz sind davon nicht betroffen. Wenn Spalten während der Tabellenerstellung definiert werden, übernehmen sie sofort den Standardrundungsmodus der Tabelle, sofern nichts anderes angegeben ist.
maxTimeTravelHours

string (Int64Value format)

Optional. Definiert das Zeitreisefenster in Stunden. Der Wert kann zwischen 48 und 168 Stunden (2 bis 7 Tage) liegen. Wenn dieser Wert nicht festgelegt ist, beträgt der Standardwert 168 Stunden.
tags[]
(deprecated)

object (GcpTag)

Nur Ausgabe. Tags für das Dataset. Verwenden Sie das Feld resourceTags, um Tags als Eingaben anzugeben.
storageBillingModel

enum (StorageBillingModel)

Optional. Aktualisiert „storage_billing_model“ für das Dataset.
restrictions

object (RestrictionConfig)

Optional. Nur Ausgabe. Einschränkungskonfiguration für alle Tabellen und das Dataset. Wenn diese Option festgelegt ist, werden bestimmte Zugriffe auf den Datensatz und alle zugehörigen Tabellen basierend auf der Konfiguration eingeschränkt. Weitere Informationen finden Sie unter Ausgehender Datenverkehr.
resourceTags

map (key: string, value: string)

Optional. Die Tags, die an dieses Dataset angehängt sind. Tag-Schlüssel sind global eindeutig. Der Tag-Schlüssel muss das Namespace-Format haben, z. B. „123456789012/environment“, wobei 123456789012 die ID der übergeordneten Organisations- oder Projektressource für diesen Tag-Schlüssel ist. Der Tag-Wert muss der Kurzname sein, z. B. „Production“. Weitere Informationen finden Sie unter Tag-Definitionen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
JSON-Darstellung 
{
  "datasetId": string,
  "projectId": string,
  "datasetIdAlternative": [
    string
  ],
  "projectIdAlternative": [
    string
  ]
}
Felder
datasetId

string

Erforderlich. Eine eindeutige ID für dieses Dataset ohne den Projektnamen. Die ID darf nur Buchstaben (a–z, A–Z), Ziffern (0–9) und Unterstriche (_) enthalten. Die maximale Länge beträgt 1.024 Zeichen.
projectId

string

Optional. Die ID des Projekts, das dieses Dataset enthält.
datasetIdAlternative[]

string

Dieses Feld sollte nicht verwendet werden.
projectIdAlternative[]

string

Dieses Feld sollte nicht verwendet werden.
JSON-Darstellung 
{
  "value": string
}
Felder
value

string

Stringwert.
JSON-Darstellung 
{
  "value": string
}
Felder
value

string (int64 format)

Der int64-Wert.
JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

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

string

Eine IAM-Rollen-ID, die dem Nutzer, der Gruppe oder der Domain gewährt werden soll, die in diesem Zugriffsdatensatz angegeben ist. Die folgenden alten Zuordnungen werden angewendet:

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

In dieses Feld können alle oben genannten Formate eingegeben werden, es wird aber nur das alte Format zurückgegeben. Wenn Sie dieses Feld beispielsweise auf „roles/bigquery.dataOwner“ festlegen, wird es als „OWNER“ zurückgegeben.
userByEmail

string

[Pick one] Eine E-Mail-Adresse eines Nutzers, dem Zugriff gewährt werden soll. Beispiel: fred@example.com. Wird dem IAM-Richtlinienmitglied „user:EMAIL“ oder „serviceAccount:EMAIL“ zugeordnet.
groupByEmail

string

[Pick one] Eine E‑Mail-Adresse einer Google-Gruppe, der Sie Zugriff gewähren möchten. Entspricht dem IAM-Richtlinienmitglied „group:GROUP“.
domain

string

[Pick one] Eine Domain, für die Sie Zugriff gewähren möchten. Alle Nutzer, die mit der angegebenen Domain angemeldet sind, erhalten den angegebenen Zugriff. Beispiel: „beispiel.de“. Entspricht dem IAM-Richtlinienmitglied „domain:DOMAIN“.
specialGroup

string

[Pick one] Eine spezielle Gruppe, der Zugriff gewährt werden soll. Mögliche Werte:

  • projectOwners: Inhaber des einschließenden Projekts.
  • projectReaders: Leser des einschließenden Projekts.
  • projectWriters: Autoren des einschließenden Projekts.
  • allAuthenticatedUsers: Alle authentifizierten BigQuery-Nutzer.

Wird ähnlichen IAM-Mitgliedern zugeordnet.
iamMember

string

[Pick one] Ein anderer Mitgliedstyp, der in der IAM-Richtlinie aufgeführt ist, aber kein Nutzer, keine Gruppe, keine Domain und keine spezielle Gruppe ist.
view

object (TableReference)

[Pick one] Eine Ansicht aus einem anderen Dataset, für die Sie Zugriff gewähren möchten. Für Abfragen, die für diese Ansicht ausgeführt werden, ist Lesezugriff auf Ansichten, Tabellen und Routinen in diesem Dataset möglich. Das Feld „role“ ist nicht erforderlich, wenn dieses Feld festgelegt ist. Wenn diese Ansicht von einem Nutzer aktualisiert wird, muss der Zugriff auf die Ansicht über einen Aktualisierungsvorgang noch einmal gewährt werden.
routine

object (RoutineReference)

[Pick one] Einen Ablauf aus einem anderen Dataset, für den Sie Zugriff gewähren möchten. Für Abfragen, die für diese Routine ausgeführt werden, ist Lesezugriff auf Ansichten, Tabellen und Routinen in diesem Dataset möglich. Derzeit wird nur UDF unterstützt. Das Feld „role“ ist nicht erforderlich, wenn dieses Feld festgelegt ist. Wenn diese Routine von einem Nutzer aktualisiert wird, muss der Zugriff auf die Routine über einen Aktualisierungsvorgang noch einmal gewährt werden.
dataset

object (DatasetAccessEntry)

[Pick one] Eine Berechtigung, die allen Ressourcen eines bestimmten Typs in einem bestimmten Dataset den Zugriff auf dieses Dataset autorisiert. Derzeit werden nur Ansichten unterstützt. Das Feld „role“ ist nicht erforderlich, wenn dieses Feld festgelegt ist. Wenn dieser Datensatz gelöscht und neu erstellt wird, muss der Zugriff über einen Aktualisierungsvorgang noch einmal gewährt werden.
condition

object (google.type.Expr)

Optional. Bedingung für die Bindung. Wenn der CEL-Ausdruck in diesem Feld „true“ ist, wird diese Zugriffsbindung berücksichtigt.
JSON-Darstellung 
{
  "projectId": string,
  "datasetId": string,
  "tableId": string,
  "projectIdAlternative": [
    string
  ],
  "datasetIdAlternative": [
    string
  ],
  "tableIdAlternative": [
    string
  ]
}
Felder
projectId

string

Erforderlich. Die ID des Projekts, das diese Tabelle enthält.
datasetId

string

Erforderlich. Die ID des Datasets, das diese Tabelle enthält.
tableId

string

Erforderlich. Die ID der Tabelle. Die ID kann Unicode-Zeichen in Kategorie L (Buchstabe), M (Zeichen), N (Zahl), Pc (Verbindungselement, einschließlich Unterstrich), Pd (Strich) und Zs (Leerzeichen) enthalten. Weitere Informationen finden Sie unter Allgemeine Kategorie. Die maximale Länge beträgt 1.024 Zeichen. Bei bestimmten Vorgängen kann die Tabellen-ID mit einem Partition-Decorator versehen werden, z. B. sample_table$20190123.
projectIdAlternative[]

string

Dieses Feld sollte nicht verwendet werden.
datasetIdAlternative[]

string

Dieses Feld sollte nicht verwendet werden.
tableIdAlternative[]

string

Dieses Feld sollte nicht verwendet werden.
JSON-Darstellung 
{
  "projectId": string,
  "datasetId": string,
  "routineId": string
}
Felder
projectId

string

Erforderlich. Die ID des Projekts, das diese Routine enthält.
datasetId

string

Erforderlich. Die ID des Datasets, das diese Routine enthält.
routineId

string

Erforderlich. Die ID der Routine. Die ID darf nur Buchstaben (a–z, A–Z), Ziffern (0–9) und Unterstriche (_) enthalten. Die maximale Länge beträgt 256 Zeichen.
JSON-Darstellung 
{
  "dataset": {
    object (DatasetReference)
  },
  "targetTypes": [
    enum (TargetType)
  ]
}
Felder
dataset

object (DatasetReference)

Das Dataset, für das dieser Eintrag gilt
targetTypes[]

enum (TargetType)

Auf welche Ressourcen im Dataset sich dieser Eintrag bezieht. Derzeit werden nur Aufrufe unterstützt. In Zukunft werden möglicherweise weitere Zieltypen hinzugefügt.
JSON-Darstellung 
{
  "expression": string,
  "title": string,
  "description": string,
  "location": string
}
Felder
expression

string

Textdarstellung eines Ausdrucks in der Common Expression Language-Syntax.
title

string

Optional. Titel für den Ausdruck, d. h. ein kurzer String, der seinen Zweck beschreibt. Diese Funktion kann z. B. in UIs verwendet werden, in denen die Eingabe von Ausdrücken zulässig ist.
description

string

Optional. Beschreibung des Ausdrucks. Dies ist ein längerer Text, der den Ausdruck beschreibt, z. B. wenn der Mauszeiger darauf bewegt wird.
location

string

Optional. Ein String, der in Fehlermeldungen den Speicherort des Ausdrucks angibt, z. B. einen Dateinamen und eine Position in der Datei.
JSON-Darstellung 
{
  "kmsKeyName": string
}
Felder
kmsKeyName

string

Optional. Beschreibt den Cloud KMS-Verschlüsselungsschlüssel, der zum Schutz der BigQuery-Zieltabelle verwendet wird. Das mit Ihrem Projekt verknüpfte BigQuery-Dienstkonto benötigt Zugriff auf diesen Verschlüsselungsschlüssel.
JSON-Darstellung 
{
  "value": boolean
}
Felder
value

boolean

Der boolesche Wert.
JSON-Darstellung 
{
  "sourceDataset": {
    object (DatasetReference)
  }
}
Felder
sourceDataset

object (DatasetReference)

Die Referenz auf das Quelldataset enthält Projektnummern und keine Projekt-IDs.
JSON-Darstellung 
{
  "linkState": enum (LinkState)
}
Felder
linkState

enum (LinkState)

Nur Ausgabe. Gibt an, ob das verknüpfte Dataset derzeit verknüpft ist.
JSON-Darstellung 
{
  "externalSource": string,
  "connection": string
}
Felder
externalSource

string

Erforderlich. Externe Quelle, die dieses Dataset unterstützt.
connection

string

Erforderlich. Die Verbindungs-ID, die für den Zugriff auf die externe Quelle verwendet wird.

Format: projects/{project_id}/locations/{location_id}/connections/{connection_id}
JSON-Darstellung 
{
  "parameters": {
    string: string,
    ...
  },
  "defaultStorageLocationUri": string
}
Felder
parameters

map (key: string, value: string)

Optional. Eine Zuordnung von Schlüssel/Wert-Paaren, die die Parameter und Attribute des Open-Source-Schemas definieren. Maximale Größe: 2 MiB.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
defaultStorageLocationUri

string

Optional. Der Speicherort-URI für alle Tabellen im Dataset. Entspricht dem Datenbank-URI des Hive-Metaspeichers. Maximale Länge: 1.024 Zeichen.
JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string
JSON-Darstellung 
{
  "tagKey": string,
  "tagValue": string
}
Felder
tagKey

string

Erforderlich. Der Namespace-freundliche Name des Tag-Schlüssels, z.B. „12345/environment“, wobei 12345 die Organisations-ID ist.
tagValue

string

Erforderlich. Der benutzerfreundliche Kurzname des Tag-Werts, z.B. „production“.
JSON-Darstellung 
{
  "type": enum (RestrictionType)
}
Felder
type

enum (RestrictionType)

Nur Ausgabe. Gibt den Typ der Einschränkung für Datasets/Tabellen an.
JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ✅ | Open-World-Hinweis: ❌