다음을 통해 공유

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 ]

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

매개 변수

  • connection_name

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

  • connection_type

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

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

  • OPTIONS

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

    • 옵션

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

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

    • value

      속성 값입니다. 값은 BOOLEAN, STRING, INTEGER 또는 DECIMAL 상수 식이어야 합니다. 값은 SECRET SQL 함수에 대한 호출일 수도 있습니다. 예를 들어 password용 value는 리터럴 비밀번호를 입력하는 것과 반대로 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'));