Delen via

Verbinding maken met Synapse SQL

  • Artikel

Maak verbinding met de Synapse-SQL-optie in Azure Synapse Analytics.

Belangrijk

Gebruik waar mogelijk Microsoft Entra-verificatie. Zie Microsoft Entra-verificatie gebruiken voor verificatie met Synapse SQL voor meer informatie.

Uw servernaam vinden

De servernaam voor de toegewezen SQL-pool in het volgende voorbeeld is: <server-name>.sql.azuresynapse.net. De servernaam voor de serverloze SQL-pool in het volgende voorbeeld is: <server-name>-ondemand.sql.azuresynapse.net.

Ga als volgt te werk om de volledig gekwalificeerde servernaam te vinden:

  1. Ga naar de Azure Portal.
  2. Selecteer Synapse-werkruimten.
  3. Selecteer de werkruimte waarmee u verbinding wilt maken.
  4. Ga naar overzicht.
  5. Zoek de volledige servernaam.
    • Gebruik SQL-eindpunt voor een toegewezen SQL-pool.
    • Gebruik sql on-demand eindpunt voor de serverloze SQL-pool.

Ondersteunde hulpprogramma's

Gebruik Azure Data Studio of SQL Server Management Studio (SSMS).

Voor serverloze SQL-pools:

Ondersteunde stuurprogramma's en verbindingsreeksen

Synapse SQL biedt ondersteuning voor ADO.NET, ODBC, PHP en JDBC. Selecteer een van de bovenstaande stuurprogramma's om de meest recente versie en documentatie te vinden. Voor het automatisch genereren van de verbindingsreeks voor het stuurprogramma dat u gebruikt vanuit de Azure-portal, selecteert u Databaseverbindingsreeksen tonen uit het voorgaande voorbeeld. Hier volgen ook enkele voorbeelden van hoe een verbindingsreeks er voor elk stuurprogramma uitziet.

Notitie

Overweeg de verbindingstime-out in te stellen op 300 seconden. De verbinding blijft dan in stand tijdens korte perioden van niet-beschikbaarheid.

Voorbeeld van ADO.NET-verbindingsreeks

In dit eenvoudige voorbeeld wordt SQL-verificatie gebruikt, maar Microsoft Entra-verificatie met ADO.NET is veiliger en wordt aanbevolen.

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;

Voorbeeld van ODBC-verbindingsreeks

In dit eenvoudige voorbeeld wordt SQL-verificatie gebruikt, maar Microsoft Entra-verificatie met ODBC is veiliger en wordt aanbevolen.

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;

Voorbeeld van PHP-verbindingsreeks

In dit eenvoudige voorbeeld wordt SQL-verificatie gebruikt, maar Microsoft Entra-verificatie met PHP is veiliger en wordt aanbevolen.

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

Voorbeeld van JDBC-verbindingsreeks

In dit eenvoudige voorbeeld wordt SQL-verificatie gebruikt, maar Microsoft Entra-verificatie met JDBC is veiliger en wordt aanbevolen.

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;

Verbindingsinstellingen

Synapse SQL standaardiseert enkele instellingen tijdens het maken van de verbinding en het maken van objecten. Deze instellingen kunnen niet worden overschreven, en omvatten:

Database-instelling Weergegeven als
ANSI_NULLS AAN
QUOTED_IDENTIFIERS AAN
DATEFORMAT mdy
DATEFIRST 7

Aanbevelingen

Azure Data Studio en Azure Synapse Studio zijn de aanbevolen hulpprogramma's voor het uitvoeren van query's van een serverloze SQL-pool.

Gerelateerde inhoud

Zie Query’s uitvoeren met Visual Studio als u verbinding wilt maken en een query wilt uitvoeren met Visual Studio. Zie Verificatie met Synapse SQL voor meer informatie over verificatieopties.