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:
- Buka portal Azure.
- Pilih ruang kerja Synapse.
- Pilih pada ruang kerja yang ingin Anda sambungkan.
- Buka Gambaran Umum.
- 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:
- Azure Data Studio didukung penuh mulai dari versi 1.18.0.
- SQL Server Management Studio didukung sebagian mulai dari versi 18.5, Anda dapat menggunakannya untuk menyambungkan dan mengkueri saja.
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.
Konten terkait
Untuk menyambungkan dan membuat kueri dengan Visual Studio, lihat Kueri dengan Visual Studio. Untuk mempelajari selengkapnya tentang opsi autentikasi, lihat Autentikasi ke Synapse SQL.