CREATE EXTERNAL LOCATION

  • Article

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

Crée un emplacement externe du nom spécifié. S’il existe déjà un emplacement du même nom, une exception est levée.

Si vous souhaitez en savoir plus sur la procédure, veuillez consulter la rubrique Créer un emplacement externe pour connecter le stockage cloud à Azure Databricks.

Syntaxe

CREATE EXTERNAL LOCATION [IF NOT EXISTS] location_name
    URL url_str
    WITH (STORAGE CREDENTIAL credential_name)
    [COMMENT comment]

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

    Nom de l’emplacement à créer.

  • IF NOT EXISTS

    Crée un emplacement du nom spécifié s’il n’en existe pas. S’il existe déjà un emplacement du même nom, rien ne se produit.

  • url_str

    Littéral STRING avec l’emplacement du stockage cloud décrit comme une URL absolue. Doit être entouré de guillemets simples.

  • credential_name

    Informations d’identification nommées utilisées pour se connecter à cet emplacement.

  • commentaire

    Description facultative de l’emplacement, ou NULL. Par défaut, il s’agit de NULL.

Exemples

-- Create a location accessed using the abfss_remote_cred credential
> CREATE EXTERNAL LOCATION abfss_remote URL 'abfss://container@storageaccount.dfs.core.windows.net/location'
    WITH (STORAGE CREDENTIAL abfss_remote_cred)
    COMMENT 'Default source for Azure exernal data';

Notez les backticks (` `) autour de l’emplacement externe et des noms d’informations d’identification de stockage dans l’exemple suivant. Les backticks sont requis pour les noms d’objets qui incluent des caractères spéciaux, tels que des traits d’union (-). Les noms d’objets avec des traits de soulignement (_) comme ceux de l’exemple précédent ne nécessitent pas de backticks. Voir Noms.

-- Create a location accessed using the abfss_remote_cred credential
> CREATE EXTERNAL LOCATION `abfss-remote` URL 'abfss://container@storageaccount.dfs.core.windows.net/location'
    WITH (STORAGE CREDENTIAL `abfss-remote-cred`)
    COMMENT 'Default source for Azure exernal data';