CRIAR LOCAL EXTERNO

  • Artigo

Aplica-se a: verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 10.4 LTS e versões posteriores caixa de seleção marcada sim Somente Catálogo do Unity

Cria um local externo com o nome especificado. Se um local com o mesmo nome já existir, uma exceção será gerada.

Para obter instruções de como fazer, veja Criar um local externo para conectar o armazenamento em nuvem ao Azure Databricks.

Sintaxe

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

Qualquer nome de objeto que inclua caracteres especiais, como hifens (-), deve ser colocado entre crases (` `). Nomes de objeto com sublinhados (_) não exigem crases. Veja Nomes e Exemplos.

Parâmetros

  • location_name

    O nome do local a ser criado.

  • IF NOT EXISTS

    Cria um local com o nome fornecido se ele não existir. Se um local com o mesmo nome já existir, nada acontecerá.

  • url_str

    Um literal STRING com o local do armazenamento em nuvem descrito como uma URL absoluta. Deve estar cercado por aspas simples.

  • credential_name

    A credencial nomeada usada para se conectar a esse local.

  • comment

    Uma descrição opcional para o local, ou NULL. O padrão é NULL.

Exemplos

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

Observe os acentos graves (` `) em volta dos nomes do local externo e das credenciais de armazenamento no exemplo a seguir. Os acentos graves são necessários para nomes de objeto que incluem caracteres especiais, como hifens (-). Nomes de objeto com sublinhados (_), como os do exemplo anterior, não exigem acentos graves. Veja Nomes.

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