إنشاء اتصال

ينطبق على:وضع علامة Databricks SQL وضع علامة Databricks Runtime 13.3 LTS وما فوق وضع علامة كتالوج Unity فقط

هام

هذه الميزة في المعاينة العامة.

ينشئ هذا الأمر اتصالا خارجيا (أو خادما)، والذي يمثل نظام بيانات عن بعد من نوع معين، باستخدام خيارات محددة للنظام توفر موقع النظام البعيد وتفاصيل المصادقة.

تمكن الاتصالات الخارجية الاستعلامات الموحدة.

بناء الجملة

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

بالنسبة إلى التوافق مع المعايير، يمكنك أيضا استخدام SERVER بدلا من CONNECTION.

المعلمات

  • connection_name

    معرف فريد للاتصال على مستوى metastore كتالوج Unity.

  • connection_type

    يحدد نوع الاتصال ويجب أن يكون واحدا من:

    • DATABRICKS
    • MYSQL
    • POSTGRESQL
    • REDSHIFT
    • SNOWFLAKE
    • SQLDW (Synapse)
    • SQLSERVER
  • خيارات

    تعيين connection_type معلمات محددة مطلوبة لتأسيس الاتصال.

    • خيار

      مفتاح الخاصية. يمكن أن يتكون المفتاح من معرف واحد أو أكثر مفصول بنقطة أو حرفيةSTRING.

      يجب أن تكون مفاتيح الخصائص فريدة وأن تكون حساسة لحالة الأحرف.

    • قيمة

      قيمة الخاصية . يجب أن تكون القيمة تعبير ثابت BOOLEANSTRINGINTEGERأو.DECIMAL قد تكون القيمة أيضا استدعاء لدالة SECRET SQL. على سبيل المثال، value قد يتكون secret('secrets.r.us', 'postgresPassword') ل password بدلا من إدخال كلمة المرور الحرفية.

مثال

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