external-locations groupe de commande

Le external-locations groupe de commandes dans l’interface CLI Databricks contient des commandes pour créer et gérer des emplacements externes pour le catalogue Unity. Découvrez quels sont les volumes du catalogue Unity ?.

databricks création d'emplacements externes

Créez une nouvelle entrée de localisation externe dans le métastore. L’appelant doit être un administrateur de metastore ou avoir le CREATE_EXTERNAL_LOCATION privilège sur le metastore et les informations d’identification de stockage associées.

databricks external-locations create NAME URL CREDENTIAL_NAME [flags]

Arguments

NAME

    Nom de l’emplacement externe.

URL

    Chemin URL de l'emplacement externe.

CREDENTIAL_NAME

    Nom des identifiants de stockage utilisés avec cet emplacement.

Options

--comment string

    Description de texte libre fournie par l’utilisateur.

--enable-file-events

    Indique s’il faut activer les événements de fichier sur cet emplacement externe.

--fallback

    Indique si le mode de secours est activé pour cet emplacement externe.

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

--read-only

    Indique si l’emplacement externe est en lecture seule.

--skip-validation

    Ignore la validation des informations d’identification de stockage associées à l’emplacement externe.

Indicateurs globaux

Examples

L’exemple suivant crée un emplacement externe avec un commentaire :

databricks external-locations create my-external-location s3://my-bucket/path my-credential --comment "External location for data lake"

L’exemple suivant démontre la création d’un emplacement externe de stockage à accès en lecture seule :

databricks external-locations create my-external-location s3://my-bucket/path my-credential --read-only

databricks supprimer emplacements externes

Supprime l’emplacement externe spécifié du metastore. L’appelant doit être le propriétaire de l’emplacement externe.

databricks external-locations delete NAME [flags]

Arguments

NAME

    Nom de l’emplacement externe.

Options

--force

    Force la suppression même s'il existe des tables externes ou des points de montage dépendants.

Indicateurs globaux

Examples

L’exemple suivant supprime un emplacement externe nommé my-external-location:

databricks external-locations delete my-external-location

L’exemple suivant supprime avec force un emplacement externe même s’il existe des dépendances :

databricks external-locations delete my-external-location --force

databricks external-locations get

Obtenez un emplacement externe depuis le métastore. L’appelant doit être un administrateur de metastore, le propriétaire de l’emplacement externe ou un utilisateur disposant d’un privilège sur l’emplacement externe.

databricks external-locations get NAME [flags]

Arguments

NAME

    Nom de l’emplacement externe.

Options

--include-browse

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

Indicateurs globaux

Examples

L’exemple suivant obtient des informations sur un emplacement externe nommé my-external-location:

databricks external-locations get my-external-location

L'exemple suivant obtient des informations, y compris les métadonnées de navigation :

databricks external-locations get my-external-location --include-browse

liste des emplacements externes de Databricks

Liste les emplacements externes à partir du metastore. L’appelant doit être un administrateur de metastore, le propriétaire de l’emplacement externe ou un utilisateur disposant d’un privilège sur l’emplacement externe. Il n’existe aucune garantie d’un classement spécifique des éléments dans le tableau.

databricks external-locations list [flags]

Options

--include-browse

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

--include-unbound

    Indique s’il faut inclure des emplacements externes non liés à l’espace de travail.

--max-results int

    Nombre maximal d’emplacements externes à retourner.

--page-token string

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

Indicateurs globaux

Examples

L’exemple suivant répertorie tous les emplacements externes :

databricks external-locations list

L’exemple suivant répertorie les emplacements externes avec un maximum de 10 résultats :

databricks external-locations list --max-results 10

mise à jour des emplacements externes de Databricks

Mettez à jour un emplacement externe dans le metastore. L’appelant doit être le propriétaire de l’emplacement externe ou être un administrateur de metastore. Dans le deuxième cas, l’administrateur ne peut mettre à jour que le nom de l’emplacement externe.

databricks external-locations update NAME [flags]

Arguments

NAME

    Nom de l’emplacement externe.

Options

--comment string

    Description de texte libre fournie par l’utilisateur.

--credential-name string

    Nom des identifiants de stockage utilisés avec cet emplacement.

--enable-file-events

    Indique s’il faut activer les événements de fichier sur cet emplacement externe.

--fallback

    Indique si le mode de secours est activé pour cet emplacement externe.

--force

    Force la mise à jour même si le changement d'URL invalide des tables externes ou des points de montage dépendants.

--isolation-mode IsolationMode

    Valeurs prises en charge : ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

--new-name string

    Nouveau nom pour l’emplacement externe.

--owner string

    Propriétaire de l’emplacement externe.

--read-only

    Indique si l’emplacement externe est en lecture seule.

--skip-validation

    Ignore la validation des informations d’identification de stockage associées à l’emplacement externe.

--url string

    Chemin URL de l'emplacement externe.

Indicateurs globaux

Examples

L’exemple suivant renomme un emplacement externe :

databricks external-locations update my-external-location --new-name my-renamed-location

L’exemple suivant modifie le propriétaire d’un emplacement externe :

databricks external-locations update my-external-location --owner someone@example.com

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