Consultar dados no Azure Data Explorer usando uma emulação do SQL Server
Qualquer biblioteca e aplicativo que possa se conectar a um Banco de Dados SQL do Microsoft Azure com autenticação do Microsoft Entra também pode se conectar ao Azure Data Explorer. Essa funcionalidade é possível graças ao ponto de extremidade compatível com TDS do Azure Data Explorer, que emula o Microsoft SQL Server. O ponto de extremidade é compatível com as versões 7.x e 8.0 do TDS.
Com a emulação do SQL Server, você pode se conectar ao Azure Data Explorer através de vários métodos, incluindo ODBC, JDBC e aplicativos comuns como LINQPad e Azure Data Studio.
Autenticação
O Azure Data Explorer requer autenticação por meio do Microsoft Entra ID.
Para autenticar uma entidade de aplicativo, é necessário incluir a ID do locatário nas opções de ajuste. Para obter um exemplo, consulte conectar com ODBC.
É possível configurar a ID de locatário do Microsoft Entra no nível do cluster e eliminar a necessidade de especificá-la no cliente. Para alterar a ID do locatário no nível do cluster, abra uma solicitação de suporte no portal do Azure sobre a configuração de SecuritySettings.TdsEndpointDefaultAuthority com a ID de locatário necessária.
Opções de ajuste
Para personalizar o Azure Data Explorer de acordo com seus requisitos específicos, você pode precisar fornecer certas informações que sem suporte pela configuração padrão da conexão do SQL Server.
Para permitir esses parâmetros, o Azure Data Explorer permite que você insira esses valores nas propriedades TDS Language e Application. Recomendamos usar a propriedade Language sempre que possível.
Opções de ajuste com suporte
A tabela a seguir descreve as opções de ajuste com suporte. Para saber como usar essas opções, consulte a explicação da sintaxe.
| Opção de ajuste | Descrição |
|---|---|
MaxStringSize |
O comportamento padrão do Azure Data Explorer é considerar os valores de cadeia de caracteres como NVARCHAR(MAX). Para aplicativos que não funcionam bem com o tipo NVARCHAR(MAX), você pode converter os dados em NVARCHAR(n). |
AadAuthority |
Usado para especificar a ID do locatário do Microsoft Entra para autenticação. |
Sintaxe
[ Language | Application ] = ExpectedArguments@TuningOptions
Saiba mais sobre as convenções de sintaxe.
Parâmetros
| Nome | Digitar | Obrigatória | Descrição |
|---|---|---|---|
| ExpectedArguments | string |
✔️ | O valor esperado para o campo Language ou Application em TDS. |
| TuningOptions | string |
Zero ou mais opções de ajuste com suporte separadas por vírgula. Cada opção de ajuste deve estar no formato TuningOptionName:TuningOptionValue. |
Exemplo
O exemplo a seguir especifica a ID de locatário do Microsoft Entra em uma cadeia de conexão ODBC usando a propriedade Language e a opção de ajuste AadAuthority.
Driver={ODBC Driver 17 for SQL Server};Server=myadxcluster.westeurope.kusto.windows.net;Database=mydatabase;Authentication=ActiveDirectoryServicePrincipal;Language=any@AadAuthority:57B489CD-590C-417F-A8B9-E75D2F9A04C8,MaxStringSize:5000;UID=A9BCAB99-8AAD-4411-A232-37E2116B935E;PWD=mysecret