Compartir vía

CREATE EXTERNAL LOCATION

  • Artículo

Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 10.4 LTS y versiones posteriores casilla marcada como Sí solo a 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';