CREATE EXTERNAL LOCATION

  • Artículo

Se aplica a:check marked yes Databricks SQL check marked yes Databricks Runtime 10.3 y versiones posteriores check marked yes Solo Unity Catalog

Crea una ubicación externa con el nombre especificado. Si ya existe una ubicación con el mismo nombre, se produce una excepción.

Para obtener instrucciones paso a paso, consulte Creación de una ubicación externa para conectar el almacenamiento en la nube a Azure Databricks.

Sintaxis

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

Cualquier nombre de objeto que incluya caracteres especiales, como guiones (-), debe estar rodeado de acentos inversas (` `). Los nombres de objeto con caracteres de subrayado (_) no requieren acentos versos. Consulte Nombres y Ejemplos.

Parámetros

  • location_name

    Nombre de la ubicación que se va a crear.

  • IF NOT EXISTS

    Crea una ubicación con el nombre especificado si no existe. Si ya existe una ubicación con el mismo nombre, no ocurrirá nada.

  • url_str

    Literal STRING con la ubicación del almacenamiento en la nube descrita como dirección URL absoluta. Debe estar rodeado de ofertas simples.

  • credential_name

    Credencial con nombre utilizada para conectarse a esta ubicación.

  • comentario

    Descripción opcional de la ubicación o NULL. El valor predeterminado es NULL.

Ejemplos 

-- 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';

Tenga en cuenta los versos (` `) alrededor de la ubicación externa y los nombres de credenciales de almacenamiento en el ejemplo siguiente. Se requieren acentos versos para los nombres de objeto que incluyen caracteres especiales, como guiones (-). Los nombres de objeto con caracteres de subrayado (_), como los del ejemplo anterior, no requieren acentos versos. Vea Nombres.

-- 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';