Puntos de conexión de SQL

Importante

Esta característica está en versión preliminar pública. Para solicitar acceso, póngase en contacto con un representante de Azure Databricks.

Un punto de conexión SQL es un recurso de cálculo que le permite ejecutar comandos SQL en objetos de datos dentro del Azure Databricks de datos.

Los puntos de conexión SQL aparecen en el historial de consultas y registran el usuario que ejecutó la consulta.

Los puntos de conexión de SQL admiten los comandos SQL en la referencia de SQL para Databricks SQL.

En esta sección se describe cómo trabajar con puntos de conexión sql mediante la interfaz de usuario. Para trabajar con puntos de conexión SQL mediante la API, consulte API de punto de conexión de SQL.

Las consultas a través de puntos de conexión DE SQL se administran mediante el watchdog de consultas con los valores predeterminados, tal y como se describe en ese artículo.

Requisitos

  • Para crear puntos de conexión SQL, debe tener el permiso decreación de clústeres , que está habilitado en el área de trabajo Data Science & Engineering.
  • Para administrar un punto de conexión SQL, debe tener el permiso Can Manage (Puede administrar) en Databricks SQL para el punto de conexión.

Visualización de puntos de conexión SQL

Haga clic  en Endpoints Icon Endpoints (Puntos de conexión) en la barra lateral.

De forma predeterminada, los puntos de conexión se ordenan en orden alfabético. Para volver a ordenar la lista, haga clic en los encabezados de columna.

Para filtrar la lista de puntos de conexión, escriba texto en el cuadro de búsqueda:

Filtrado de puntos de conexión

Crear un punto de conexión de SQL

  1. Haga clic  en Endpoints Icon Endpoints (Puntos de conexión) en la barra lateral.

  2. Haga clic en + Nuevo punto de conexión de SQL.

    ![Crear punto de conexión2}

  3. Escriba el nombre del punto de conexión. Acepte o edite las propiedades del punto de conexión.

  4. Haga clic en Crear.

  5. Realice una de las siguientes acciones:

    El punto de conexión se crea e inicia.

Iniciar, detener o eliminar un punto de conexión SQL

  1. Haga clic  en Endpoints Icon Endpoints (Puntos de conexión) en la barra lateral.
  2. En la columna Actions (Acciones), haga clic en los puntos suspensivos verticales Vertical Ellipsis (Puntos suspensivos verticales) y seleccione  Start(Inicio), Stop (Detener) o Delete (Eliminar).

Consulte también Configuración de una entidad de servicio.

Edición de un punto de conexión SQL

  1. Haga clic  en Endpoints Icon Endpoints (Puntos de conexión) en la barra lateral.
  2. Haga clic en un extremo.
  3. Haga clic en Editar.
  4. Edite las propiedades del punto de conexión.
    • Tamaño del clúster: el número de trabajadores del clúster y el tamaño del coordinador. El valor predeterminado es X-Large. Para reducir la latencia de las consultas, aumente el tamaño. Un tamaño mayor tiene un coordinador mayor y duplica el número de trabajadores del clúster. Para más información, consulte Tamaño del clúster.

    • Detener automáticamente: si el punto de conexión se detiene si está inactivo durante el número de minutos especificado. El valor predeterminado es On con un valor de 120 minutos.

      Nota

      Los puntos de conexión DE SQL inactivos siguen acumulando cargos de DBU y de instancia en la nube hasta que se detienen.

    • Equilibrio de carga de varios clústeres: número mínimo y máximo de clústeres en los que se distribuyen las consultas enviadas al punto de conexión. El valor predeterminado es Desactivado con un máximo de 1 clúster. Cuando se establece en On, el valor predeterminado es 1 clúster como mínimo y máximo 2 clústeres.

      Para controlar más usuarios simultáneos para una consulta determinada, active el equilibrio de carga y aumente el número de clústeres.

    • Photon: si las consultas se ejecutan en el motor vectorizado nativo de Photon que acelera la ejecución de consultas. El valor predeterminado es On.

      Para ver cuánto de una consulta se ejecutó con Photon:

      1. Haga clic  en Historial Historial de iconos en la barra lateral.
      2. Haga clic en una consulta.
      3. En el panel Detalles de la consulta, haga clic en Detalles de ejecución.
      4. Mire la métrica Task Time in Photon (Tiempo de tarea en Photon) en la parte inferior.

      En general, cuanto mayor sea el porcentaje de tiempo de tarea en Photon, mayor será la ventaja de rendimiento de Photon.

    • Permisos: usuarios y grupos que pueden administrar y usar el punto de conexión.

    • Etiquetas: anotaciones de pares clave-valor que pueden identificar quién usa el punto de conexión.

  5. Haga clic en Guardar o Guardar y reinicie.

Editar permisos de punto de conexión

Para editar los permisos de punto de conexión:

  1. Haga clic en la pestaña Botón Permisos .

    Se muestran los permisos del punto de conexión de SQL. El creador del punto de conexión y Azure Databricks administradores tienen el permiso Puede administrar.

    Agregar permiso

  2. Seleccione un usuario o grupo y un permiso.

  3. Haga clic en Agregar.

  4. Haga clic en Save(Guardar).

Adición de una etiqueta de punto de conexión

Las etiquetas permiten supervisar fácilmente el costo de los recursos en la nube que usan varios grupos de la organización. Puede especificar etiquetas como pares clave-valor al crear un punto de conexión y Azure Databricks estas etiquetas a los recursos en la nube.

Para agregar una etiqueta de punto de conexión:

  1. Haga clic  en Endpoints Icon Endpoints (Puntos de conexión) en la barra lateral.

  2. Haga clic en un extremo.

  3. Haga clic en Editar.

  4. En la fila Etiquetas, escriba una clave de etiqueta y un valor.

    Agregar etiqueta

  5. Haga clic en Guardar y reinicie.

Supervisión de un punto de conexión sql

Puede examinar el número de consultas que controla el punto de conexión y el número de clústeres asignados al punto de conexión.

  1. Haga clic  en Endpoints Icon Endpoints (Puntos de conexión) en la barra lateral.

  2. Haga clic en un extremo.

  3. Haga clic en Supervisión.

    Se muestra un gráfico que muestra el número de consultas que controla el punto de conexión y el número de clústeres asignados al punto de conexión durante las últimas 6 horas.

    Haga clic en un botón de escala de tiempo situado en la parte superior derecha del gráfico para cambiar el período mostrado. Por ejemplo, en la captura de pantalla siguiente se muestran estas estadísticas durante 7 días:

    Supervisión del punto de conexión

    Nota

    El número de clústeres solo puede ser mayor que uno si el equilibrio de carga de varios clústeres está habilitado y configurado.

Tamaño del clúster

En la tabla de esta sección se asigna el tamaño del clúster del punto de conexión de SQL Azure Databricks el tamaño del controlador del clúster y los recuentos de trabajo.

Tamaño del clúster Driver size (Tamaño del controlador) Recuento de trabajadores
2X-Small Standard_E8_v3 1
X-Small Standard_E8_v3 2
Pequeña Standard_E16_v3 4
Media Standard_E32_v3 8
grande Standard_E32_v3 16
Mas grande Standard_E64_v3 32
2X-Large Standard_E64_v3 64
3X-Large Standard_E64_v3 128
4X-Large Standard_E64_v3 256

El tamaño de instancia de todos los trabajadores es Standard_E8_v3.

Cada controlador y trabajo tiene conectados ocho discos administrados LRS estándar de 128 GB. Los discos conectados se cobran por hora.