Consultar dados no Azure Data Explorer com a emulação do SQL Server
Qualquer biblioteca e aplicação que se possa ligar a um Base de Dados SQL do Microsoft Azure com a autenticação Microsoft Entra também pode ligar-se ao Azure Data Explorer. Esta funcionalidade é possibilitada pelo ponto final compatível com o TDS do Azure Data Explorer, que emula o microsoft SQL Server. O ponto final suporta as versões 7.x e 8.0 do TDS.
Com SQL Server emulação, pode ligar-se ao Azure Data Explorer através de vários métodos, incluindo ODBC, JDBC e aplicações comuns como o LINQPad e o Azure Data Studio.
Autenticação
O Azure Data Explorer requer autenticação através de Microsoft Entra ID.
Para autenticar um principal de aplicação, tem de incluir o ID do inquilino nas opções de otimização. Por exemplo, veja Ligar com o ODBC.
É possível configurar o ID de inquilino Microsoft Entra ao nível do cluster e remover a necessidade de o especificar do cliente. Para alterar o ID do inquilino ao nível do cluster, abra um pedido de suporte no portal do Azure sobre como configurar SecuritySettings.TdsEndpointDefaultAuthority com o ID de inquilino necessário.
Opções de otimização
Para personalizar o Azure Data Explorer de acordo com os seus requisitos específicos, poderá ter de fornecer determinadas informações que não são suportadas pela configuração padrão SQL Server ligação.
Para permitir tais parâmetros, o Azure Data Explorer permite-lhe introduzir estes valores no TDS Language e Application nas propriedades. Recomendamos que utilize a Language propriedade sempre que possível.
Opções de otimização suportadas
A tabela seguinte descreve as opções de otimização suportadas. Para saber como utilizar estas opções, veja a explicação da sintaxe .
| Opção de otimização | Description |
|---|---|
MaxStringSize |
O comportamento predefinido do Azure Data Explorer é considerar os valores de cadeia como NVARCHAR(MAX). Para aplicações que não funcionam bem com o NVARCHAR(MAX) tipo, pode converter os dados em NVARCHAR(n). |
AadAuthority |
Utilizado para especificar o ID de inquilino Microsoft Entra para autenticação. |
Syntax
[ Language | Application ] =ExpectedArguments@TuningOptions
Saiba mais sobre as convenções de sintaxe.
Parâmetros
| Nome | Tipo | Necessário | Descrição |
|---|---|---|---|
| ExpectedArguments | string |
✔️ | O valor esperado para o Language campo ou Application no TDS. |
| TuningOptions | string |
Zero ou mais opções de otimização suportadas separadas por vírgulas. Cada opção de otimização tem de estar no formato TuningOptionName:TuningOptionValue. |
Exemplo
O exemplo seguinte especifica o ID de inquilino Microsoft Entra numa cadeia de ligação ODBC com a Language propriedade e a opção AadAuthority de otimização.
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