Csatlakozás a Synapse SQL-hez sqlcmd használatával

Tip

Microsoft Fabric Data Warehouse egy nagyvállalati szintű relációs raktár egy Data Lake-alaprendszeren, jövőre kész architektúrával, beépített AI-vel és új funkciókkal. Ha még nem ismerkedik adattárházzal, kezdje a Fabric Data Warehouse. A meglévő dedikált SQL-készlet számítási feladatai frissíthetők Fabric az adatelemzés, a valós idejű elemzés és a jelentéskészítés új képességeinek eléréséhez.

Az sqlcmd parancssori segédprogrammal csatlakozhat és lekérdezheti a kiszolgáló nélküli SQL-készletet és a dedikált SQL-készletet a Synapse SQL-ben.

1. Csatlakozás

Az sqlcmd használatának megkezdéséhez nyissa meg a parancssort, és adja meg az sqlcmd parancsot, majd a Synapse SQL-adatbázis kapcsolati sztringét. A kapcsolati sztringhez a következő paraméterek szükségesek:

  • Kiszolgáló (-S): a következő formában <Server Name>-ondemand.sql.azuresynapse.net (Kiszolgáló nélküli SQL-készlet) vagy <Server Name>.sql.azuresynapse.net (Dedikált SQL-készlet)
  • Adatbázis (-d): Adatbázis neve
  • Idézett azonosítók engedélyezése (-I): Az idézett azonosítókat engedélyezni kell a Synapse SQL-példányhoz való csatlakozáshoz

Az SQL Server-hitelesítés használatához hozzá kell adnia a felhasználónév és a jelszó paramétereit:

  • Felhasználó (-U): Kiszolgálófelhasználó az űrlapon <Felhasználó>
  • Jelszó (-P): A felhasználóhoz társított jelszó

A kapcsolati sztring a következő példához hasonlóan nézhet ki:

kiszolgáló nélküli SQL-készlet

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

dedikált SQL-készlet

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

A Microsoft Entra integrált hitelesítés használatához hozzá kell adnia a Microsoft Entra paramétereit:

  • Microsoft Entra-hitelesítés (-G): a Microsoft Entra-azonosító használata hitelesítéshez

A kapcsolati karakterlánc az alábbi példák egyikéhez hasonlóan nézhet ki:

kiszolgáló nélküli SQL-készlet

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

dedikált SQL-készlet

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

Megjegyzés

Engedélyeznie kell a Microsoft Entra-hitelesítést az Active Directory használatával történő hitelesítéshez.

2. Lekérdezés

Dedikált SQL-készlet használata

A kapcsolat után bármilyen támogatott Transact-SQL utasítást (T-SQL) kibocsáthat a példány ellen. Ebben a példában a lekérdezések interaktív módban lesznek elküldve:

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

Dedikált SQL tárterület esetén az alábbi példák bemutatják, hogyan futtathat lekérdezéseket kötegelt módban a -Q beállítással, vagy hogyan irányíthatja az SQL-t a sqlcmd programhoz.

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

Kiszolgáló nélküli SQL-készlet használata

Csatlakozás után bármely támogatott Transact-SQL (T-SQL) utasítást kibocsáthat a kiszolgálóra. A következő példában a lekérdezések interaktív módban lesznek elküldve:

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

Kiszolgáló nélküli SQL-készlet esetén az alábbi példák bemutatják, hogyan futtathat lekérdezéseket kötegelt módban a -Q beállítással, vagy hogyan pipálhatja az SQL-t az sqlcmd-be:

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

Következő lépések

Az sqlcmd-beállításokkal kapcsolatos további információkért tekintse meg az sqlcmd dokumentációját.