Menyambungkan ke Synapse SQL

Terhubung ke kemampuan Synapse SQL di Azure Synapse Analytics.

Alat yang didukung untuk kumpulan SQL tanpa server

Azure Data Studio didukung penuh mulai dari versi 1.18.0. SSMS didukung sebagian mulai dari versi 18.5, Anda dapat menggunakannya untuk menghubungkan dan membuat kueri saja.

Menemukan nama server Anda

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

Untuk menemukan nama server yang sepenuhnya memenuhi syarat:

  1. Buka portal Microsoft Azure.
  2. Pilih ruang kerja Synapse.
  3. Pilih pada ruang kerja yang ingin Anda sambungkan.
  4. Buka Gambaran Umum.
  5. Temukan nama server lengkap.

Kumpulan SQL

Full server name

Kumpulan SQL tanpa server

Full server name serverless SQL pool

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

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

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

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

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.

Langkah berikutnya

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