다음을 통해 공유

CREATE CONNECTION

  • 아티클

적용 대상:체크 표시 예 Databricks SQL 체크 표시 예 Databricks Runtime 13.3 LTS 이상 체크 표시 예 Unity 카탈로그 전용

Important

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

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

외부 연결을 사용하면 페더레이션된 쿼리를 수행할 수 있습니다.

구문

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

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

매개 변수

  • connection_name

    Unity 카탈로그 메타스토어 수준에서 연결의 고유 식별자입니다.

  • connection_type

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

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

  • OPTIONS

    연결을 설정하는 데 필요한 connection_type 특정 매개 변수를 설정합니다.

    • 옵션

      속성 키입니다. 키는 점 또는 리터럴로 구분된 하나 이상의 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'));