tables Befehlsgruppe

Note

Diese Informationen gelten für Databricks CLI-Versionen 0.205 und höher. Die Databricks CLI befindet sich in der öffentlichen Vorschau.

Die Verwendung von Databricks CLI unterliegt der Datenbricks-Lizenz - und Databricks-Datenschutzerklärung, einschließlich der Bestimmungen zu Nutzungsdaten.

Die tables Befehlsgruppe in der Databricks CLI enthält Befehle zum Verwalten von Tabellen im Unity-Katalog. Eine Tabelle befindet sich in der dritten Ebene des dreistufigen Namespaces von Unity Catalog. Sie enthält Datenzeilen.

Databricks-Tabellen löschen

Löschen Sie eine Tabelle aus dem angegebenen übergeordneten Katalog und Schema. Der Aufrufer muss der Besitzer des übergeordneten Katalogs sein, über die USE_CATALOG Berechtigungen für den übergeordneten Katalog verfügen und der Besitzer des übergeordneten Schemas sein, oder der Besitzer der Tabelle sein und über die USE_CATALOG Berechtigungen für den übergeordneten Katalog und die USE_SCHEMA Berechtigungen für das übergeordnete Schema verfügen.

databricks tables delete FULL_NAME [flags]

Arguments

FULL_NAME

    Vollständiger Name der Tabelle.

Options

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird eine Tabelle gelöscht:

databricks tables delete my_catalog.my_schema.my_table

Databricks-Tabellen sind vorhanden.

Rufen Sie ab, ob eine Tabelle im Metastore für einen bestimmten Katalog und ein bestimmtes Schema vorhanden ist. Der Anrufer muss eine der folgenden Anforderungen erfüllen:

• Sie sind Metastore-Administrator*in.
• Sie sind besitzende Person des übergeordneten Katalogs.
• Sie sind besitzende Person des übergeordneten Schemas und verfügen über die Berechtigung USE_CATALOG für den übergeordneten Katalog.
• Verfügen Sie über die USE_CATALOG Berechtigung für den übergeordneten Katalog und die USE_SCHEMA Berechtigung für das übergeordnete Schema, und seien Sie entweder der Tabellenbesitzer oder verfügen Sie über die SELECT Berechtigung für die Tabelle.
• Gewährt die Berechtigung BROWSE für den übergeordneten Katalog
• Sie verfügen über die Berechtigung BROWSE für das übergeordnete Schema.

databricks tables exists FULL_NAME [flags]

Arguments

FULL_NAME

    Vollständiger Name der Tabelle.

Options

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird überprüft, ob eine Tabelle vorhanden ist:

databricks tables exists my_catalog.my_schema.my_table

Databricks-Tabellen abrufen

Dient zum Abrufen einer Tabelle aus dem Metaspeicher für einen bestimmten Katalog und ein bestimmtes Schema. Der Anrufer muss eine der folgenden Anforderungen erfüllen:

• Sie sind Metastore-Administrator*in.
• Sie sind besitzende Person des übergeordneten Katalogs.
• Sie sind besitzende Person des übergeordneten Schemas und verfügen über die Berechtigung USE_CATALOG für den übergeordneten Katalog.
• Verfügen Sie über die USE_CATALOG Berechtigung für den übergeordneten Katalog und die USE_SCHEMA Berechtigung für das übergeordnete Schema, und seien Sie entweder der Tabellenbesitzer oder verfügen Sie über die SELECT Berechtigung für die Tabelle.

databricks tables get FULL_NAME [flags]

Arguments

FULL_NAME

    Vollständiger Name der Tabelle.

Options

--include-browse

    Gibt an, ob Tabellen in die Antwort einbezogen werden sollen, bei denen der Prinzipal nur auf selektive Metadaten zugreifen kann.

--include-delta-metadata

    Gibt an, ob Delta-Metadaten in die Antwort einbezogen werden sollen.

--include-manifest-capabilities

    Gibt an, ob ein Manifest mit Funktionen eingeschlossen werden soll, über die die Tabelle verfügt.

Globale Kennzeichnungen

Examples

Das folgende Beispiel ruft Informationen zu einer Tabelle ab:

databricks tables get my_catalog.my_schema.my_table

Im folgenden Beispiel wird eine Tabelle mit eingeschlossenen Delta-Metadaten angezeigt:

databricks tables get my_catalog.my_schema.my_table --include-delta-metadata

Databricks-Tabellenliste

Listet alle Tabellen für den aktuellen Metastore unter dem übergeordneten Katalog und Schema auf. Der Aufrufer muss ein Metastore-Administrator oder ein Besitzer der Tabelle sein (oder über die SELECT Berechtigungen verfügen). Im letzteren Fall muss der Aufrufer auch der Besitzer sein oder über die USE_CATALOG Berechtigungen für den übergeordneten Katalog und die USE_SCHEMA Berechtigungen für das übergeordnete Schema verfügen. Es gibt keine Garantie für eine bestimmte Reihenfolge der Elemente im Array.

databricks tables list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Name des übergeordneten Katalogs für Tabellen von Interesse.

SCHEMA_NAME

    Übergeordnetes Schema von Tabellen.

Options

--include-browse

    Gibt an, ob Tabellen in die Antwort einbezogen werden sollen, bei denen der Prinzipal nur auf selektive Metadaten zugreifen kann.

--include-delta-metadata

    Gibt an, ob Delta-Metadaten in die Antwort einbezogen werden sollen.

--include-manifest-capabilities

    Gibt an, ob ein Manifest mit Funktionen eingeschlossen werden soll, über die die Tabelle verfügt.

--max-results int

    Maximale Anzahl der zurückzugebenden Tabellen.

--omit-columns

    Gibt an, ob die Spalten der Tabelle aus der Antwort weggelassen werden sollen.

--omit-properties

    Gibt an, ob die Eigenschaften der Tabelle aus der Antwort weggelassen werden sollen.

--omit-username

    Gibt an, ob der Benutzername der Tabelle weggelassen werden soll (z. B.

--page-token string

    Undurchsichtiges Token, das für die nächste Seite der Ergebnisse (Paginierung) gesendet werden soll.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden alle Tabellen in einem Katalog und Schema aufgelistet:

databricks tables list my_catalog my_schema

Im folgenden Beispiel werden Tabellen mit ausgelassenen Spalten aufgelistet:

databricks tables list my_catalog my_schema --omit-columns

databricks tables list-summaries

Erstellen Sie Zusammenfassungen für Tabellen innerhalb eines Schemas und eines Katalogs im Metastore. Die zurückgegebenen Tabellenzusammenfassungen:

• Zusammenfassungen für Tabellen (innerhalb des aktuellen Metastores und des übergeordneten Katalogs und Schemas), wenn der Benutzer ein Metastore-Administrator ist,
• oder Zusammenfassungen für Tabellen und Schemas (im aktuellen Metastore und übergeordneten Katalog), deren Eigentümer der Benutzer ist, oder wenn er die Berechtigung SELECT für die Tabelle und das Eigentum hat oder die Berechtigung USE_SCHEMA für das Schema, sofern der Benutzer zudem Eigentümer des übergeordneten Katalogs ist oder für diesen die Berechtigung USE_CATALOG hat.

Es gibt keine Garantie für eine bestimmte Reihenfolge der Elemente im Array.

databricks tables list-summaries CATALOG_NAME [flags]

Arguments

CATALOG_NAME

    Name des übergeordneten Katalogs für Tabellen von Interesse.

Options

--include-manifest-capabilities

    Gibt an, ob ein Manifest mit Funktionen eingeschlossen werden soll, über die die Tabelle verfügt.

--max-results int

    Maximale Anzahl von Zusammenfassungen für Tabellen, die zurückgegeben werden sollen.

--page-token string

    Nicht transparentes Paginierungstoken, um basierend auf der vorherigen Abfrage zur nächsten Seite zu gelangen.

--schema-name-pattern string

    Ein SQL LIKE-Muster (% und _) für Schemanamen.

--table-name-pattern string

    Ein SQL LIKE-Muster (% und _) für Tabellennamen.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden Tabellenzusammenfassungen für einen Katalog aufgelistet:

databricks tables list-summaries my_catalog

Im folgenden Beispiel werden Tabellenzusammenfassungen mit Schemanamenmustern aufgelistet:

databricks tables list-summaries my_catalog --schema-name-pattern "prod_%"

Im folgenden Beispiel werden die Tabellenzusammenfassungen anhand des Namensschemas der Tabellen aufgelistet.

databricks tables list-summaries my_catalog --table-name-pattern "fact_%"

Globale Kennzeichnungen

--debug

  Gibt an, ob die Debugprotokollierung aktiviert werden soll.

-h oder --help

    Hilfe für die Databricks CLI oder die zugehörige Befehlsgruppe oder den zugehörigen Befehl anzeigen.

--log-file Schnur

    Eine Zeichenfolge, die die Datei darstellt, in die Ausgabeprotokolle geschrieben werden sollen. Wenn dieses Flag nicht angegeben ist, werden Ausgabeprotokolle standardmäßig in stderr geschrieben.

--log-format Format

    Der Protokollformattyp text oder json. Der Standardwert ist text.

--log-level Schnur

    Eine Zeichenfolge, die die Protokollformatebene darstellt. Wenn nicht angegeben, ist die Protokollformatebene deaktiviert.

-o, --output Typ

    Der Befehlsausgabetyp text oder json. Der Standardwert ist text.

-p, --profile Schnur

    Der Name des Profils in der ~/.databrickscfg Datei, das zum Ausführen des Befehls verwendet werden soll. Wenn dieses Flag nicht angegeben ist, aber existiert, wird das Profil DEFAULT verwendet.

--progress-format Format

    Das Format zum Anzeigen von Statusprotokollen: default, , append, inplaceoder json

-t, --target Schnur

    Falls zutreffend, das zu verwendende Bündelziel