Compartir a través de

Consultar datos en Azure Data Explorer mediante emulación de SQL Server

  • Artículo

Cualquier biblioteca y aplicación que pueda conectarse a una base de datos de Microsoft Azure SQL Database con la autenticación de Microsoft Entra también pueden conectarse a Azure Data Explorer. Esta funcionalidad es posible mediante el punto de conexión compatible con TDS de Azure Data Explorer, que emula Microsoft SQL Server. El punto de conexión admite las versiones 7.x y 8.0 de TDS.

Con la emulación de SQL Server, puede conectarse a Azure Data Explorer a través de varios métodos, incluidos ODBC, JDBC y aplicaciones comunes como LINQPad y Azure Data Studio.

Autenticación

Azure Data Explorer requiere autenticación a través de Microsoft Entra ID.

Para autenticar una entidad de seguridad de aplicación, debe incluir el identificador de inquilino en las opciones de optimización. Para obtener un ejemplo, consulte Conexión con ODBC.

Es posible configurar el identificador de inquilino de Microsoft Entra en el nivel de clúster y quitar la necesidad de especificarlo del cliente. Para cambiar el id. de inquilino a nivel de clúster, abra una solicitud de soporte en Azure Portal sobre la configuración de SecuritySettings.TdsEndpointDefaultAuthority con el id. de inquilino requerido.

Opciones de ajuste

Para personalizar Azure Data Explorer de acuerdo con sus requisitos específicos, es posible que tenga que proporcionar cierta información que no es compatible con la configuración de conexión estándar de SQL Server.

Para permitir estos parámetros, Azure Data Explorer le permite introducir estos valores en las propiedades TDS Language y Application. Recomendamos usar la propiedad Language siempre que sea posible.

Opciones de ajuste admitidas

En la tabla siguiente se describen las opciones de ajuste admitidas. Para obtener información sobre cómo usar estas opciones, consulte la explicación de la sintaxis.

Opción de ajuste Descripción
MaxStringSize El comportamiento predeterminado de Azure Data Explorer es considerar los valores de cadena como NVARCHAR(MAX). Para las aplicaciones que no funcionan bien con el tipo NVARCHAR(MAX), puede convertir los datos a NVARCHAR(n).
AadAuthority Se usa para especificar el id. de inquilino de Microsoft Entra para la autenticación.

Sintaxis

[ Language | Application ] = ExpectedArguments@TuningOptions

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Type Obligatorio Descripción
ExpectedArguments string ✔️ El valor esperado para el campo Language o Application en TDS.
TuningOptions string Cero o más opciones de ajuste compatibles separadas por comas. Cada opción de ajuste debe tener el formato TuningOptionName:TuningOptionValue.

Ejemplo

En el ejemplo siguiente se especifica el identificador de inquilino de Microsoft Entra en una cadena de conexión ODBC mediante la propiedad Language y la opción 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

Contenido relacionado