Teilen über

Herstellen einer Verbindung mit Synapse SQL mit sqlcmd

Sie können das Befehlszeilenprogramm sqlcmd verwenden, um eine Verbindung zu dem serverlosen SQL-Pool und dem dedizierten SQL-Pool innerhalb von Synapse SQL herzustellen und die Pools abzufragen.

1. Verbinden

Um mit sqlcmd zu beginnen, öffnen Sie die Eingabeaufforderung, und geben Sie sqlcmd gefolgt von der Verbindungszeichenfolge für Ihre Synapse SQL-Datenbank ein. Für die Verbindungszeichenfolge sind die folgenden Parameter erforderlich:

  • Server (-S): Server im Format <Server Name-ondemand.sql.azuresynapse.net>(Serverless SQL Pool) oder <Server Name.sql.azuresynapse.net>(Dedizierter SQL-Pool)
  • Datenbank (-d): Datenbankname
  • Aktivieren von Bezeichnern in Anführungszeichen (-I): Bezeichner in Anführungszeichen müssen aktiviert sein, um eine Verbindung mit einer Synapse-SQL-Instanz herzustellen.

Um die SQL Server-Authentifizierung zu verwenden, müssen Sie die Benutzernamen- und Kennwortparameter hinzufügen:

  • Benutzer (-U): Serverbenutzer im Format <Benutzer>
  • Kennwort (-P): Dem Benutzer zugeordnetes Kennwort

Ihre Verbindungszeichenfolge könnte wie im folgenden Beispiel aussehen:

Serverless SQL-Pool

C:\>sqlcmd -S partyeunrt-ondemand.sql.azuresynapse.net -d demo -U Enter_Your_Username_Here -P Enter_Your_Password_Here -I

Dedizierter SQL-Pool

C:\>sqlcmd -S MySqlDw.sql.azuresynapse.net -d Adventure_Works -U myuser -P myP@ssword -I

Um die integrierte Microsoft Entra-Authentifizierung zu verwenden, müssen Sie die Microsoft Entra-Parameter hinzufügen:

  • Microsoft Entra-Authentifizierung (-G): Microsoft Entra-ID für die Authentifizierung verwenden

Ihre Verbindungszeichenfolge sieht möglicherweise wie in den folgenden Beispielen aus:

Serverless SQL-Pool

C:\>sqlcmd -S partyeunrt-ondemand.sql.azuresynapse.net -d demo -G -I

Dedizierter SQL-Pool

C:\>sqlcmd -S MySqlDw.sql.azuresynapse.net -d Adventure_Works -G -I

Hinweis

Sie müssen die Microsoft Entra-Authentifizierung für die Authentifizierung mit Active Directory aktivieren.

2. Abfrage

Verwenden eines dedizierten SQL-Pools

Nach der Verbindung können Sie alle unterstützten Transact-SQL (T-SQL)- Anweisungen für die Instanz ausgeben. In diesem Beispiel werden Abfragen im interaktiven Modus übermittelt:

C:\>sqlcmd -S MySqlDw.sql.azuresynapse.net -d Adventure_Works -U myuser -P myP@ssword -I
1> SELECT name FROM sys.tables;
2> GO
3> QUIT

In den folgenden Beispielen für dedizierten SQL-Pool wird gezeigt, wie Sie Abfragen im Batchmodus mithilfe der Option -Q ausführen oder Ihre SQL in sqlcmd leiten:

sqlcmd -S MySqlDw.sql.azuresynapse.net -d Adventure_Works -U myuser -P myP@ssword -I -Q "SELECT name FROM sys.tables;"

"SELECT name FROM sys.tables;" | sqlcmd -S MySqlDw.sql.azuresynapse.net -d Adventure_Works -U myuser -P myP@ssword -I > .\tables.out

Verwenden eines serverlosen SQL-Pools

Nach dem Herstellen einer Verbindung können Sie alle unterstützten Transact-SQL (T-SQL)-Anweisungen für die Instanz ausgeben. Im folgenden Beispiel werden Abfragen im interaktiven Modus übermittelt:

C:\>sqlcmd -S partyeunrt-ondemand.sql.azuresynapse.net -d demo -U Enter_Your_Username_Here -P Enter_Your_Password_Here -I
1> SELECT COUNT(*) FROM  OPENROWSET(BULK 'https://azureopendatastorage.blob.core.windows.net/censusdatacontainer/release/us_population_county/year=20*/*.parquet', FORMAT='PARQUET')
2> GO
3> QUIT

Für serverlose SQL-Pools zeigen die folgenden Beispiele, wie Sie Abfragen im Batchmodus mithilfe der Option -Q ausführen oder Ihre SQL-Datei in sqlcmd leiten:

sqlcmd -S partyeunrt-ondemand.sql.azuresynapse.net -d demo -U Enter_Your_Username_Here -P 'Enter_Your_Password_Here' -I -Q "SELECT COUNT(*) FROM  OPENROWSET(BULK 'https://azureopendatastorage.blob.core.windows.net/censusdatacontainer/release/us_population_county/year=20*/*.parquet', FORMAT='PARQUET')"

"SELECT COUNT(*) FROM  OPENROWSET(BULK 'https://azureopendatastorage.blob.core.windows.net/censusdatacontainer/release/us_population_county/year=20*/*.parquet', FORMAT='PARQUET')" | sqlcmd -S partyeunrt-ondemand.sql.azuresynapse.net -d demo -U Enter_Your_Username_Here -P 'Enter_Your_Password_Here' -I > ./tables.out

Nächste Schritte

Weitere Informationen zu sqlcmd-Optionen finden Sie in der sqlcmd-Dokumentation.

  • Last updated on