CRIAR CONEXÃO
Aplica-se a: SQL do Databricks Databricks Runtime 13.3 LTS e superior Somente Catálogo do Unity
Importante
Esse recurso está em uma versão prévia.
Esse comando cria uma conexão estrangeira (ou servidor), que representa um sistema de dados remoto de um tipo específico, usando opções específicas do sistema que fornecem o local do sistema remoto e detalhes de autenticação.
As conexões estrangeiras habilitam consultas federadas.
Sintaxe
CREATE CONNECTION [IF NOT EXISTS] connection_name
TYPE connection_type
OPTIONS ( option value [, ...] )
[ COMMENT comment ]
Para conformidade com padrões, você também pode usar SERVER
em vez de CONNECTION
.
Parâmetros
connection_name
Um identificador exclusivo da conexão no nível do metastore do Catálogo do Unity.
connection_type
Identifica o tipo da conexão e deve ser um dos seguintes:
DATABRICKS
MYSQL
POSTGRESQL
REDSHIFT
SNOWFLAKE
SQLDW
(Synapse)SQLSERVER
OPTIONS
Define parâmetros de
connection_type
específicos necessários para estabelecer a conexão.option
A chave da propriedade. A chave pode consistir de um ou mais identificadores separados por um ponto ou uma literal de
STRING
.As chaves de propriedade devem ser exclusivas e diferenciar maiúsculas de minúsculas.
value
O valor para a propriedade. O valor deve ser uma expressão de constante
BOOLEAN
,STRING
,INTEGER
ouDECIMAL
. O valor também pode ser uma chamada para a função SQLSECRET
. Por exemplo, ovalue
para apassword
pode ser composto desecret('secrets.r.us', 'postgresPassword')
em vez de inserir a senha literal.
Exemplo
-- Create a postgresql connection
> CREATE CONNECTION postgresql_connection
TYPE POSTGRESQL
OPTIONS (
host 'qf-postgresql-demo.xxxxxx.us-west-2.rds.amazonaws.com',
port '5432',
user 'postgresql_user',
password 'password123');
-- Create a postgresql connection with secret scope
> CREATE CONNECTION postgresql_connection
TYPE POSTGRESQL
OPTIONS (
host 'qf-postgresql-demo.xxxxxx.us-west-2.rds.amazonaws.com',
port '5432',
user secret('secrets.r.us', 'postgresUser'),
password secret('secrets.r.us', 'postgresPassword'));