tables groupe de commande

Note

Ces informations s’appliquent à Databricks CLI versions 0.205 et ultérieures. L’interface CLI Databricks est en préversion publique.

L’utilisation de l’interface CLI Databricks est soumise à la licence Databricks et à la notification de confidentialité Databricks, y compris les dispositions relatives aux données d’utilisation.

Le tables groupe de commandes dans l’interface CLI Databricks contient des commandes pour gérer les tables dans le catalogue Unity. Une table se trouve dans la troisième couche d'un espace de noms hiérarchique en trois niveaux dans le catalogue Unity. Il contient des lignes de données.

supprimer des tables dans Databricks

Supprimez une table du catalogue et du schéma parent spécifiés. L’appelant doit être le propriétaire du catalogue parent, avoir le USE_CATALOG privilège sur le catalogue parent et être le propriétaire du schéma parent, ou être le propriétaire de la table et avoir le USE_CATALOG privilège sur le catalogue parent et le USE_SCHEMA privilège sur le schéma parent.

databricks tables delete FULL_NAME [flags]

Arguments

FULL_NAME

    Nom complet de la table.

Options

Indicateurs globaux

Examples

L’exemple suivant supprime une table :

databricks tables delete my_catalog.my_schema.my_table

Les tables Databricks existent.

Déterminez si une table existe dans le metastore pour un catalogue et un schéma spécifiques. L’appelant doit répondre à l’une des exigences suivantes :

• Être administrateur du metastore
• Être propriétaire du catalogue parent
• Être propriétaire du schéma parent et disposer du privilège USE_CATALOG sur le catalogue parent
• Disposer des privilèges USE_CATALOG sur le catalogue parent et USE_SCHEMA sur le schéma parent, et être soit propriétaire de la table, soit disposer du privilège SELECT pour la table.
• Disposer du privilège BROWSE pour le catalogue parent.
• Disposer du privilège BROWSE pour le schéma parent.

databricks tables exists FULL_NAME [flags]

Arguments

FULL_NAME

    Nom complet de la table.

Options

Indicateurs globaux

Examples

L’exemple suivant vérifie si une table existe :

databricks tables exists my_catalog.my_schema.my_table

Commandes de tables Databricks

Récupère une table du metastore pour un catalogue et un schéma spécifiques. L’appelant doit répondre à l’une des exigences suivantes :

• Être administrateur du metastore
• Être propriétaire du catalogue parent
• Être propriétaire du schéma parent et disposer du privilège USE_CATALOG sur le catalogue parent
• Disposer des privilèges USE_CATALOG sur le catalogue parent et USE_SCHEMA sur le schéma parent, et être soit propriétaire de la table, soit disposer du privilège SELECT pour la table.

databricks tables get FULL_NAME [flags]

Arguments

FULL_NAME

    Nom complet de la table.

Options

--include-browse

    Indique s’il faut inclure des tables dans la réponse pour laquelle le principal peut uniquement accéder aux métadonnées sélectives.

--include-delta-metadata

    Indique si les métadonnées delta doivent être incluses dans la réponse.

--include-manifest-capabilities

    Indique s’il faut inclure un manifeste contenant des fonctionnalités dont la table dispose.

Indicateurs globaux

Examples

L’exemple suivant obtient des informations sur la table :

databricks tables get my_catalog.my_schema.my_table

L’exemple suivant obtient une table avec des métadonnées delta incluses :

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

Liste des tables Databricks

Liste toutes les tables du metastore actuel, sous le catalogue et schéma parent spécifiés. L’appelant doit être un administrateur de metastore ou un propriétaire de (ou avoir le privilège SELECT pour) la table. Pour ce dernier cas, l’appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent ainsi que le privilège USE_SCHEMA sur le schéma parent. Il n’existe aucune garantie d’un classement spécifique des éléments dans le tableau.

databricks tables list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Nom du catalogue parent des tables concernées.

SCHEMA_NAME

    Schéma parent des tables.

Options

--include-browse

    Indique s’il faut inclure des tables dans la réponse pour laquelle le principal peut uniquement accéder aux métadonnées sélectives.

--include-delta-metadata

    Indique si les métadonnées delta doivent être incluses dans la réponse.

--include-manifest-capabilities

    Indique s’il faut inclure un manifeste contenant des fonctionnalités dont la table dispose.

--max-results int

    Nombre maximal de tables à retourner.

--omit-columns

    Indique s’il faut omettre les colonnes de la table de la réponse ou non.

--omit-properties

    Indique s’il faut omettre les propriétés de la table de la réponse ou non.

--omit-username

    Indique s’il faut omettre le nom d’utilisateur de la table (par exemple,

--page-token string

    Jeton opaque à envoyer pour la page suivante des résultats (pagination).

Indicateurs globaux

Examples

L’exemple suivant répertorie toutes les tables d’un catalogue et d’un schéma :

databricks tables list my_catalog my_schema

L’exemple suivant répertorie les tableaux avec des colonnes omises :

databricks tables list my_catalog my_schema --omit-columns

databricks tables liste-résumés

Répertorie les résumés des tables d’un schéma et d’un catalogue dans le metastore. Les résumés de tableau retournés sont les suivants :

• soit des résumés de tables (dans le metastore actuel, le catalogue parent et le schéma parent) si l’utilisateur est administrateur de metastore ;
• soit des résumés de tables et de schémas (dans le metastore actuel et le catalogue parent) pour lesquels l’utilisateur possède la propriété ou le privilège SELECT pour la table, ainsi que la propriété ou le privilège USE_SCHEMA pour le schéma, à condition que l’utilisateur possède également la propriété ou le privilège USE_CATALOG pour le catalogue parent.

Il n’existe aucune garantie d’un classement spécifique des éléments dans le tableau.

databricks tables list-summaries CATALOG_NAME [flags]

Arguments

CATALOG_NAME

    Nom du catalogue parent des tables concernées.

Options

--include-manifest-capabilities

    Indique s’il faut inclure un manifeste contenant des fonctionnalités dont la table dispose.

--max-results int

    Nombre maximal de résumés pour les tables à renvoyer.

--page-token string

    Jeton de pagination opaque pour accéder à la page suivante en fonction de la requête précédente.

--schema-name-pattern string

    Modèle LIKE sql (% et _) pour les noms de schémas.

--table-name-pattern string

    Modèle LIKE sql (% et _) pour les noms de tables.

Indicateurs globaux

Examples

L’exemple suivant répertorie les résumés de tableau d’un catalogue :

databricks tables list-summaries my_catalog

L’exemple suivant répertorie les résumés de tableau avec le modèle de nom de schéma :

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

L’exemple suivant répertorie les résumés de tableau avec le modèle de nom de table :

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

Indicateurs globaux

--debug

  Active la journalisation du débogage.

-h ou --help

    Affiche l’aide pour l’interface CLI de Databricks, le groupe de commandes associé ou la commande concernée.

--log-file chaîne

    Chaîne représentant le fichier dans lequel écrire les journaux de sortie. Si cet indicateur n’est pas défini, les journaux de sortie sont écrits par défaut dans stderr.

--log-format format

    Format des journaux : text ou json. La valeur par défaut est text.

--log-level chaîne

    Chaîne représentant le niveau de journalisation. Si cet indicateur n’est pas défini, le niveau de format de journal est désactivé.

Type -o, --output

    Type de sortie de commande, text ou json. La valeur par défaut est text.

-p, --profile chaîne

    Nom du profil dans le ~/.databrickscfg fichier à utiliser pour exécuter la commande. Si cet indicateur n’est pas spécifié, s’il existe, le profil nommé DEFAULT est utilisé.

--progress-format format

    Format d’affichage des journaux d’activité de progression : default, append, inplace ou json

-t, --target chaîne

    Le cas échéant, la cible d’offre groupée à utiliser