Bagikan melalui


Menyambungkan ke Synapse SQL

Terhubung ke kemampuan Synapse SQL di Azure Synapse Analytics.

Penting

Gunakan autentikasi Microsoft Entra jika memungkinkan. Untuk informasi lebih lanjut, lihat Menggunakan autentikasi Microsoft Entra untuk autentikasi dengan Synapse SQL.

Menemukan nama server Anda

Nama server untuk kumpulan SQL khusus dalam contoh berikut adalah: <server-name>.sql.azuresynapse.net. Nama server untuk kumpulan SQL tanpa server dalam contoh berikut ini adalah: <server-name>-ondemand.sql.azuresynapse.net.

Untuk menemukan nama server yang sepenuhnya memenuhi syarat:

  1. Buka portal Azure.
  2. Pilih ruang kerja Synapse.
  3. Pilih pada ruang kerja yang ingin Anda sambungkan.
  4. Buka Gambaran Umum.
  5. Temukan nama server lengkap.
    • Untuk kumpulan SQL khusus, gunakan Titik Akhir SQL.
    • Untuk kumpulan SQL tanpa server, gunakan titik akhir sesuai permintaan SQL.

Alat yang didukung

Gunakan Azure Data Studio atau SQL Server Management Studio (SSMS).

Untuk kumpulan SQL tanpa server:

Driver dan string koneksi yang didukung

Synapse SQL mendukung ADO.NET, ODBC, PHP, dan JDBC. Untuk menemukan versi dan dokumentasi terbaru, pilih salah satu driver sebelumnya. Untuk menghasilkan string koneksi secara otomatis untuk driver yang Anda gunakan dari portal Microsoft Azure, pilih Perlihatkan string koneksi database dari contoh sebelumnya. Berikut ini juga beberapa contoh seperti apa string koneksi untuk setiap driver.

Catatan

Pertimbangkan untuk mengatur batas waktu koneksi hingga 300 detik untuk memungkinkan koneksi Anda bertahan dalam waktu singkat tanpa tersedia.

Contoh string koneksi ADO.NET

Contoh sederhana ini menggunakan autentikasi SQL, tetapi autentikasi Microsoft Entra dengan ADO.NET lebih aman dan direkomendasikan.

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;

Contoh string koneksi ODBC

Contoh sederhana ini menggunakan autentikasi SQL, tetapi autentikasi Microsoft Entra dengan ODBC lebih aman dan direkomendasikan.

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;

Contoh string koneksi PHP

Contoh sederhana ini menggunakan autentikasi SQL, tetapi autentikasi Microsoft Entra dengan PHP lebih aman dan direkomendasikan.

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

Contoh string koneksi JDBC

Contoh sederhana ini menggunakan autentikasi SQL, tetapi autentikasi Microsoft Entra dengan JDBC lebih aman dan direkomendasikan.

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;

Pengaturan koneksi

Synapse SQL menstandarkan beberapa pengaturan selama pembuatan koneksi dan objek. Setelan ini tidak bisa ditimpa dan mencakup:

Pengaturan Database Nilai
ANSI_NULLS AKTIF
QUOTED_IDENTIFIERS AKTIF
DATEFORMAT mdy
DATEFIRST 7

Rekomendasi

Untuk menjalankan kueri kumpulan SQL tanpa server, alat yang disarankan adalah Azure Data Studio dan Azure Synapse Studio.

Untuk menyambungkan dan membuat kueri dengan Visual Studio, lihat Kueri dengan Visual Studio. Untuk mempelajari selengkapnya tentang opsi autentikasi, lihat Autentikasi ke Synapse SQL.