groupe de commandestables

remarque

L'utilisation de Databricks CLI est soumise à la licence Databricks et à la politique de confidentialité Databricks, y compris toutes les dispositions relatives aux données d'utilisation.

Le groupe de commandes tables au sein de la Databricks CLI contient des commandes pour gérer les tables dans Unity Catalog. Une table réside dans la troisième couche de l'espace de noms à trois niveaux d'Unity Catalog. Il contient des lignes de données.

Création de tables Databricks

Créer une nouvelle table dans le catalogue et le schéma spécifiés.

remarque

Cette API prend uniquement en charge la création de tables Delta externes . Seuls TABLE_TYPE=EXTERNAL et DATA_SOURCE_FORMAT=DELTA sont pris en charge. Les masques de colonne ne sont pas pris en charge lors de la création de tables par le biais de cette API.

Pour créer une table Delta externe, l'appelant doit disposer de EXTERNAL_USE_SCHEMA sur le schéma parent et de EXTERNAL_USE_LOCATION sur l'emplacement externe, en plus des privilèges standard USE_CATALOG, CREATE_TABLE, USE_SCHEMA et CREATE_EXTERNAL_TABLE. Le champ columns doit être dans un format compatible avec Spark.

databricks tables create NAME CATALOG_NAME SCHEMA_NAME TABLE_TYPE DATA_SOURCE_FORMAT STORAGE_LOCATION [flags]

Arguments

NAME

Nom de la table, relatif au schéma parent.

CATALOG_NAME

Nom du catalogue parent.

SCHEMA_NAME

Nom du schéma parent, par rapport à son catalogue parent.

TABLE_TYPE

Le type de la table. Valeurs prises en charge : EXTERNAL, EXTERNAL_SHALLOW_CLONE, FOREIGN, MANAGED, MANAGED_SHALLOW_CLONE, MATERIALIZED_VIEW, METRIC_VIEW, STREAMING_TABLE, VIEW.

DATA_SOURCE_FORMAT

Le format de la source de données de la table. Valeurs prises en charge : AVRO, CSV, DELTA, DELTASHARING, HIVE, ICEBERG, JSON, ORC, PARQUET, TEXT et autres.

STORAGE_LOCATION

URL racine de stockage pour la table (requise pour les tables MANAGED et EXTERNAL).

Options

--json JSON

La chaîne JSON en ligne ou le @chemin vers le fichier JSON avec le corps de la requête.

Indicateurs globaux

Exemples

L'exemple suivant crée une table Delta externe :

Bash

databricks tables create my_table my_catalog my_schema EXTERNAL DELTA s3://my-bucket/my-table

suppression de tables Databricks

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

databricks tables delete FULL_NAME [flags]

Arguments

FULL_NAME

Nom complet de la table.

Options

Indicateurs globaux

Exemples

L'exemple suivant supprime une table :

Bash

databricks tables delete my_catalog.my_schema.my_table

databricks tables exists

Vérifiez si une table existe dans le metastore pour un catalogue et un schéma spécifiques. L'appelant doit satisfaire à l'une des exigences suivantes :

• Être administrateur du métastore
• Soyez le propriétaire du catalogue parent
• Soyez le propriétaire du schéma parent et disposez du privilège USE_CATALOG sur le catalogue parent.
• Disposez du privilège USE_CATALOG sur le catalogue parent et du privilège USE_SCHEMA sur le schéma parent, et soyez le propriétaire de la table ou disposez du privilège SELECT sur la table.
• Disposer du privilège BROWSE sur le catalogue parent
• Avoir le privilège BROWSE sur le schéma parent.

databricks tables exists FULL_NAME [flags]

Arguments

FULL_NAME

Nom complet de la table.

Options

Indicateurs globaux

Exemples

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

Bash

databricks tables exists my_catalog.my_schema.my_table

Obtenir les tables Databricks

Obtenez une table du metastore pour un catalogue et un schéma spécifiques. L'appelant doit satisfaire à l'une des exigences suivantes :

• Être administrateur du métastore
• Soyez le propriétaire du catalogue parent
• Soyez le propriétaire du schéma parent et disposez du privilège USE_CATALOG sur le catalogue parent.
• Disposez du privilège USE_CATALOG sur le catalogue parent et du privilège USE_SCHEMA sur le schéma parent, et soyez le propriétaire de la table ou disposez du privilège SELECT sur la table.

databricks tables get FULL_NAME [flags]

Arguments

FULL_NAME

Nom complet de la table.

Options

--include-browse

S'il faut inclure les tables dans la réponse pour lesquelles le principal ne peut accéder qu'à des 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

Faut-il inclure un manifeste contenant les fonctionnalités de la table.

Indicateurs globaux

Exemples

L'exemple suivant obtient des informations sur une table :

Bash

databricks tables get my_catalog.my_schema.my_table

L'exemple suivant obtient une table avec les métadonnées delta incluses :

Bash

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

liste des tables databricks

Lister toutes les tables pour le metastore actuel sous le catalogue et le schéma parents. L'appelant doit être un administrateur de métastore ou un propriétaire de (ou disposer du privilège SELECT sur) la table. Pour ce dernier cas, l'appelant doit également être le propriétaire ou disposer du privilège USE_CATALOG sur le catalogue parent et du privilège USE_SCHEMA sur le schéma parent. Il n'y a aucune garantie d'un ordre spécifique des éléments dans le tableau.

databricks tables list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

Nom du catalogue parent pour les tables d'intérêt.

SCHEMA_NAME

Schéma parent des tables.

Options

--include-browse

S'il faut inclure les tables dans la réponse pour lesquelles le principal ne peut accéder qu'à des 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

Faut-il inclure un manifeste contenant les fonctionnalités de la table.

--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 ou non les propriétés de la table de la réponse.

--omit-username

S'il faut omettre le nom d'utilisateur de la table (par ex.

--page-token string

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

Indicateurs globaux

Exemples

L'exemple suivant liste toutes les tables dans un catalogue et un schéma :

Bash

databricks tables list my_catalog my_schema

L'exemple suivant liste les tables avec des colonnes omises :

Bash

databricks tables list my_catalog my_schema --omit-columns

databricks tables list-summaries

Listez les résumés pour les tables d'un schéma et d'un catalogue au sein du metastore. Les résumés de table retournés sont :

• résumés des tables (au sein du métastore actuel et du catalogue et schéma parents), lorsque l'utilisateur est un administrateur du métastore,
• ou des résumés pour les tables et les schémas (au sein du métastore actuel et du catalogue parent) pour lesquels l'utilisateur dispose de la propriété ou du privilège SELECT sur la table et de la propriété ou du privilège USE_SCHEMA sur le schéma, à condition que l'utilisateur dispose également de la propriété ou du privilège USE_CATALOG sur le catalogue parent.

Il n’y a aucune garantie d’un ordre spécifique des éléments dans le tableau.

databricks tables list-summaries CATALOG_NAME [flags]

Arguments

CATALOG_NAME

Nom du catalogue parent pour les tables d'intérêt.

Options

--include-manifest-capabilities

Faut-il inclure un manifeste contenant les fonctionnalités de la table.

--max-results int

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

--page-token string

Jeton de pagination opaque pour aller à la page suivante basé sur la query précédente.

--schema-name-pattern string

Un modèle LIKE SQL (% et _) pour les noms de schémas.

--table-name-pattern string

Un modèle LIKE SQL (% et _) pour les noms de table.

Indicateurs globaux

Exemples

L'exemple suivant répertorie les récapitulatifs de table pour un catalogue :

Bash

databricks tables list-summaries my_catalog

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

Bash

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

L'exemple suivant répertorie les récapitulatifs de table avec le modèle de nom de table :

Bash

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

Drapeaux globaux

--debug

Activer ou non la journalisation de débogage.

-h OU --help

Afficher l'aide de Databricks CLI ou du groupe de commandes associé ou de la commande associée.

--log-file chaîne

Une chaîne représentant le fichier dans lequel écrire les logs de sortie. Si cet indicateur n'est pas spécifié, la default est d'écrire les logs de sortie dans stderr.

--log-format Format

Le type de format de log, text ou json. La valeur par default est text.

--log-level chaîne

Une chaîne représentant le niveau de format du log. S'il n'est pas spécifié, le niveau de format du log est désactivé.

-o, --output Type

Le type de sortie de commande, text ou json. La valeur par default est text.

-p, --profile chaîne

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

--progress-format Format

Le format pour afficher les logs de progression : default, append, inplace ou json

-t, --target chaîne

Le cas échéant, la cible de bundle à utiliser