다음을 통해 공유

CREATE CONNECTION

  • 아티클

적용 대상:체크 마크 예 Databricks SQL 체크 마크 예 Databricks Runtime 13.3 LTS 이상 체크 마크 예 Unity Catalog에만 해당

Important

이 기능은 공개 미리 보기 상태입니다.

이 명령은 원격 시스템의 위치 및 인증 세부 정보를 제공하는 시스템별 옵션을 사용하여 특정 형식의 원격 데이터 시스템을 나타내는 외딴 연결(또는 서버)을 만듭니다.

외부 connections페더레이션된 쿼리활성화합니다.

구문

CREATE CONNECTION [IF NOT EXISTS] connection_name
  TYPE connection_type
  OPTIONS ( option value [, ...] )
  [ COMMENT comment ]

표준 규정 준수의 경우 대신 사용할 SERVERCONNECTION수도 있습니다.

Parameters

  • connection_name

    Unity Catalog 메타스토어 수준의 연결에 고유한 identifier.

  • connection_type

    연결 유형을 식별하며 다음 중 하나여야 합니다.

    • DATABRICKS
    • MYSQL
    • POSTGRESQL
    • REDSHIFT
    • SNOWFLAKE
    • SQLDW (Synapse)
    • SQLSERVER

  • OPTIONS

    연결을 설정하는 데 필요한 connection_type 특정 parameters을 설정합니다.

    • 옵션

      속성 키입니다. 키는 점 또는 리터럴로 구분된 하나 이상의 STRING로 구성될 수 있습니다.

      속성 키는 고유해야 하며 대/소문자를 구분해야 합니다.

    • value

      속성 값입니다. 값은 BOOLEAN, STRING, INTEGER 또는 DECIMAL 상수 식이어야 합니다. 값은 SECRET SQL 함수에 대한 호출일 수도 있습니다. 예를 들어 value용 password는 리터럴 비밀번호를 입력하는 것과 반대로 secret('secrets.r.us', 'postgresPassword')를 구성할 수 있습니다.

예시

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