Partilhar via

CRIAR LOCALIZAÇÃO EXTERNA

  • Artigo

Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime 10.4 LTS e superior Marque Sim somente Unity Catalog

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

Para obter instruções de instruções, consulte 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 hífenes (-), deve ser cercado por backticks (` `). Os nomes de objetos com sublinhados (_) não exigem backticks. Consulte Nomes e exemplos.

Parâmetros

  • location_name

    O nome do local a ser criado.

  • SE NÃO EXISTIR

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

  • url_str

    Um STRING literal com a localização do armazenamento em nuvem descrito como um URL absoluto. Deve ser cercado por aspas simples.

  • credential_name

    A credencial nomeada usada para se conectar a esse local.

  • comentar

    Uma descrição opcional para o local, ou NULL. A predefiniçã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 backticks (` `) em torno do local externo e nomes de credenciais de armazenamento no exemplo a seguir. Backticks são necessários para nomes de objetos que incluem caracteres especiais, como hífenes (-). Nomes de objetos com sublinhados (_), como os do exemplo anterior, não exigem backticks. Consulte 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';