使用 sqlcmd 连接到 Synapse SQL

可以使用 sqlcmd 命令行实用工具在 Synapse SQL 中连接到和查询无服务器 SQL 池和专用 SQL 池。

1.连接

若要开始使用sqlcmd，请打开命令提示符并输入sqlcmd，然后输入您的 Synapse SQL 数据库的连接字符串。 connection string需要以下参数：

• Server（-S）： 服务器，格式为 <Server Name>-ondemand.sql.azuresynapse.azure.cn（无服务器 SQL 库）或 <Server Name>.sql.azuresynapse.azure.cn（专用 SQL 库）
• 数据库 (-d)：数据库名称
• 启用带引号的标识符 (-I)： 必须启用带引号的标识符才能连接到 Synapse SQL 实例

若要使用SQL Server身份验证，需要添加用户名和密码参数：

• 用户 (-U)：采用 <用户> 格式的服务器用户
• 密码 (-P)：与用户关联的密码

您的连接字符串可能如下示例所示：

无服务器 SQL 池

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

专用 SQL 池

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

若要使用 Microsoft Entra 集成身份验证，需要添加 Microsoft Entra 参数：

• Microsoft Entra 身份验证（-G）：使用Microsoft Entra ID进行身份验证

您的连接字符串可能像以下示例之一：

无服务器 SQL 池

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

专用 SQL 池

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

2.查询

使用专用 SQL 池

连接后，可以针对实例发出任何受支持的 Transact-SQL 语句。 在此示例中，查询是以交互模式提交的：

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

针对专用 SQL 池，以下示例展示了如何使用 -Q 选项或将 SQL 输送到 sqlcmd，以便在批处理模式下运行查询：

sqlcmd -S MySqlDw.sql.azuresynapse.azure.cn -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.azure.cn -d Adventure_Works -U myuser -P myP@ssword -I > .\tables.out

使用无服务器 SQL 池

连接后，可以针对实例发出任何受支持的 Transact-SQL （T-SQL） 语句。 在以下示例中，查询是以交互模式提交的：

C:\>sqlcmd -S partyeunrt-ondemand.sql.azuresynapse.azure.cn -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

针对无服务器 SQL 池，以下示例展示了如何使用 -Q 选项或将 SQL 输送到 sqlcmd，以便在批处理模式下运行查询：

sqlcmd -S partyeunrt-ondemand.sql.azuresynapse.azure.cn -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.azure.cn -d demo -U Enter_Your_Username_Here -P 'Enter_Your_Password_Here' -I > ./tables.out

后续步骤

有关 sqlcmd 选项的详细信息，请参阅 sqlcmd 文档。