Partager via

ALTER EXTERNAL LOCATION

  • Article

S’applique à : coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 10.4 LTS et ultérieur coche pour oui Unity Catalog uniquement

Modifie les propriétés d’un emplacement externe ou renomme l’emplacement.

Syntaxe

ALTER EXTERNAL LOCATION location_name
   { RENAME TO to_location_name |
     SET URL url_str [ FORCE ] |
     SET STORAGE CREDENTIAL credential_name |
     [ SET ] OWNER TO principal }

Tout nom d’objet qui inclut des caractères spéciaux, tels que des traits d’union (-), doit être entouré d’accents graves (` `). Les noms d’objets avec traits de soulignement (_) ne nécessitent pas d’accents graves. Consultez Noms et Exemples.

Paramètres

  • location_name

    Identifie l’emplacement externe en cours de modification.

  • RENOMMER EN to_location_name

    Renomme l’emplacement. Le nom doit être unique parmi tous les emplacements dans le metastore.

  • DÉFINIR L’URL url_str [ FORCE ]

    url_str doit être un STRING littéral avec l’emplacement du stockage cloud décrit comme une URL absolue.

    À défaut de spécifier FORCE, l’instruction échoue si l’emplacement est en cours d’utilisation.

  • DÉFINIR L'IDENTIFIANT DE STOCKAGE credential_name

    Met à jour les informations d’identification nommées utilisées pour accéder à cet emplacement. Si les informations d’identification n’existent pas, Databricks SQL génère une erreur.

  • [ SET ] PROPRIÉTAIRE DU principal

    Transfère la propriété de l’emplacement de stockage à principal.

    S’applique à : coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 11.3 LTS et ultérieur

    SET est autorisé en tant que mot clé facultatif.

Exemples

Les exemples suivants utilisent des noms d’emplacements qui ne contiennent pas de caractères spéciaux, tels que des traits d’union (-). Tout nom d’objet qui comporte des caractères spéciaux doit être entouré d’accents graves (` `). Voir Noms.

-- Rename a location
> ALTER EXTERNAL LOCATION descend_loc RENAME TO decent_loc;

-- Redirect the URL associated with the location
> ALTER EXTERNAL LOCATION best_loc SET URL 'abfss://container@storageaccount.dfs.core.windows.net/best_location' FORCE;

-- Change the credentials used to access the location
> ALTER EXTERNAL LOCATION best_loc SET STORAGE CREDENTIAL street_cred;

-- Change ownership of the external location
> ALTER EXTERNAL LOCATION best_loc OWNER TO `alf@melmak.et`