Consultar dados no Azure Data Explorer com a emulação do SQL Server

  • Artigo

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

Conteúdo relacionado