Share via


Verbinding maken met Synapse SQL met sqlcmd

U kunt het opdrachtregelprogramma sqlcmd gebruiken om verbinding te maken met een serverloze SQL-pool en toegewezen SQL-pool in Synapse SQL en er query's op uit te voeren.

1. Verbinding maken

Als u aan de slag wilt met sqlcmd, opent u de opdrachtprompt en voert u sqlcmd in, gevolgd door de verbindingsreeks voor uw Synapse SQL-database. Voor de verbindingsreeks zijn de volgende parameters vereist:

  • Server (-S): Server in de vorm <servernaam-ondemand.sql.azuresynapse.net> (serverloze SQL-pool) of <servernaam.sql.azuresynapse.net>(toegewezen SQL-pool)
  • Database (-d): Databasenaam
  • Aanhalingstekengevoelige id's inschakelen (-I): Aanhalingstekengevoelige id's moeten zijn ingeschakeld om verbinding te maken met een Synapse SQL-exemplaar

Als u SQL Server-verificatie wilt gebruiken, moet u de parameters voor gebruikersnaam en wachtwoord toevoegen:

  • Gebruiker (-U): Servergebruiker in de vorm <Gebruiker>
  • Wachtwoord (-P): Wachtwoord dat is gekoppeld aan de gebruiker

Uw verbindingsreeks ziet er mogelijk uit zoals in het volgende voorbeeld:

Serverloze SQL-pool

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

Toegewezen SQL-pool

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

Als u geïntegreerde Microsoft Entra-verificatie wilt gebruiken, moet u de Microsoft Entra-parameters toevoegen:

  • Microsoft Entra-verificatie (-G): Microsoft Entra-id gebruiken voor verificatie

De verbindingsreeks ziet er mogelijk uit zoals in de volgende voorbeelden:

Serverloze SQL-pool

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

Toegewezen SQL-pool

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

Opmerking

U moet Microsoft Entra-verificatie inschakelen voor verificatie met behulp van Active Directory.

2. Zoekopdracht

Toegewezen SQL-pool gebruiken

Na het maken van de verbinding kunt u alle ondersteunde Transact-SQL-instructies (T-SQL) voor het exemplaar uitvoeren. In dit voorbeeld worden query's verzonden in de interactieve modus:

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

Voor een toegewezen SQL-pool ziet u in de volgende voorbeelden hoe u query's uitvoert in de batchmodus met behulp van de optie -Q of uw SQL naar sqlcmd doorsluizen:

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

Serverloze SQL-pool gebruiken

Nadat u verbinding hebt gemaakt, kunt u alle ondersteunde Transact-SQL-instructies (T-SQL) voor het exemplaar uitgeven. In het volgende voorbeeld worden query's verzonden in de interactieve modus:

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

Voor een serverloze SQL-pool ziet u in de volgende voorbeelden hoe u query's uitvoert in de batchmodus met behulp van de optie -Q of uw SQL doorsluizen naar sqlcmd:

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

Volgende stappen

Zie de sqlcmd-documentatie voor meer informatie over sqlcmd-opties.