الاتصال بـ Synapse SQL

احصل على اتصال بإمكانية SQL Synapse في Azure Synapse Analytics.

هام

استخدم مصادقة Microsoft Entra عندما يكون ذلك ممكنا. لمزيد من المعلومات، راجع استخدام مصادقة Microsoft Entra للمصادقة مع Synapse SQL.

البحث عن اسم الخادم

اسم الخادم لتجمع SQL المخصص في المثال التالي هو: <server-name>.sql.azuresynapse.net. اسم الخادم لتجمع لغة SQL بلا خادم في المثال التالي هو: <server-name>-ondemand.sql.azuresynapse.net.

اسم الخادم المؤهل بالكامل

  1. انتقل إلى مدخل Azure.
  2. التحديد على Synapse workspaces .
  3. حدد على مساحة العمل التي تريد الاتصال بها.
  4. انتقل إلى نظرة عامة.
  5. حدد موقع اسم الملقم الكامل.
    • بالنسبة إلى تجمع SQL مخصص، استخدم نقطة نهاية SQL.
    • بالنسبة إلى تجمع SQL بلا خادم، استخدم نقطة نهاية SQL عند الطلب.

الأدوات المدعومة

استخدم Azure Data Studio أو SQL Server Management Studio (SSMS).

لتجمعات SQL بلا خادم:

برامج التشغيل المعتمدة وسلاسل الاتصال

Synapse SQL يدعم ADO.NETو ODBC وPHP وJDBC. للبحث عن أحدث إصدار ووثائق، حدد أحد برامج التشغيل السابقة. لإنشاء سلسلة الاتصال لبرنامج التشغيل الذي تستخدمه من مدخل Azure تلقائيا، حدد إظهار سلاسل اتصال قاعدة البيانات من المثال السابق. فيما يلي بعض الأمثلة على ما تبدو عليه سلسلة الاتصال لكل برنامج تشغيل.

إشعار

ضع في اعتبارك تعيين مهلة الاتصال على 300 ثانية للسماح بالاتصال أن يستمر لفترات قصيرة من عدم التوفر.

مثال سلسلة اتصال ADO.NET

يستخدم هذا المثال البسيط مصادقة SQL، ولكن مصادقة Microsoft Entra مع ADO.NET أكثر أمانا وموصى بها.

Server=tcp:{your_server}.sql.azuresynapse.net,1433;Database={your_database};User ID={your_user_name};Password={your_password_here};Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;

مثال سلسلة اتصال ODBC

يستخدم هذا المثال البسيط مصادقة SQL، ولكن مصادقة Microsoft Entra مع ODBC أكثر أمانا وموصى بها.

Driver={SQL Server Native Client 11.0};Server=tcp:{your_server}.sql.azuresynapse.net,1433;Database={your_database};Uid={your_user_name};Pwd={your_password_here};Encrypt=yes;TrustServerCertificate=no;Connection Timeout=30;

مثال سلسلة اتصال PHP

يستخدم هذا المثال البسيط مصادقة SQL، ولكن مصادقة Microsoft Entra مع PHP أكثر أمانا وموصى بها.

Server: {your_server}.sql.azuresynapse.net,1433 \r\nSQL Database: {your_database}\r\nUser Name: {your_user_name}\r\n\r\nPHP Data Objects(PDO) Sample Code:\r\n\r\ntry {\r\n   $conn = new PDO ( \"sqlsrv:server = tcp:{your_server}.sql.azuresynapse.net,1433; Database = {your_database}\", \"{your_user_name}\", \"{your_password_here}\");\r\n    $conn->setAttribute( PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION );\r\n}\r\ncatch ( PDOException $e ) {\r\n   print( \"Error connecting to SQL Server.\" );\r\n   die(print_r($e));\r\n}\r\n\rSQL Server Extension Sample Code:\r\n\r\n$connectionInfo = array(\"UID\" => \"{your_user_name}\", \"pwd\" => \"{your_password_here}\", \"Database\" => \"{your_database}\", \"LoginTimeout\" => 30, \"Encrypt\" => 1, \"TrustServerCertificate\" => 0);\r\n$serverName = \"tcp:{your_server}.sql.azuresynapse.net,1433\";\r\n$conn = sqlsrv_connect($serverName, $connectionInfo);

مثال سلسلة اتصال JDBC

يستخدم هذا المثال البسيط مصادقة SQL، ولكن مصادقة Microsoft Entra مع JDBC أكثر أمانا وموصى بها.

jdbc:sqlserver://yourserver.sql.azuresynapse.net:1433;database=yourdatabase;user={your_user_name};password={your_password_here};encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.sql.azuresynapse.net;loginTimeout=30;

إعدادات الاتصال

SQL Synapse توحيد بعض الإعدادات أثناء الاتصال وإنشاء الكائن. لا يمكن تجاوز هذه الإعدادات ويجب تضمين:

إعداد قاعدة البيانات القيمة‬
ANSI_NULLS تشغيل
QUOTED_IDENTIFIERS تشغيل
DATEFORMAT mdy
DATEFIRST 7

التوصيات

لتنفيذ استعلامات serverless SQL pool، الأدوات الموصى بها هي Azure Data Studio وAzure Synapse Studio.

للاتصال والاستعلام عن Visual Studio، راجع الاستعلام باستخدام Visual Studio. لمعرفة المزيد حول خيارات المصادقة، راجع المصادقة على SQL Synapse.