SQLfunciones de edición de la extensión JupyterLab SQL - Amazon SageMaker

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

SQLfunciones de edición de la extensión JupyterLab SQL

La SQL extensión proporciona comandos mágicos que habilitan las funcionalidades del SQL editor en las celdas de su JupyterLab cuaderno.

Si es usuario de la versión 1.6 de la imagen de SageMaker distribución, debe cargar la biblioteca mágica de SQL extensiones ejecutándola %load_ext amazon_sagemaker_sql_magic en un JupyterLab cuaderno. Esto activa las funciones SQL de edición.

Para los usuarios de las versiones 1.7 y posteriores de imágenes de SageMaker distribución, no es necesario realizar ninguna acción: la SQL extensión se carga automáticamente.

Una vez cargada la extensión, añade el comando %%sm_sql mágico al principio de una celda para activar las siguientes funciones del SQL editor.

  • Menú desplegable de selección de conexiones: al añadir un comando %%sm_sql mágico a una celda, aparece un menú desplegable en la parte superior de la celda con las conexiones a las fuentes de datos disponibles. Seleccione una conexión para rellenar automáticamente los parámetros necesarios para consultar esa fuente de datos. A continuación se muestra un ejemplo de una cadena de comandos %%sm_sql mágica generada al seleccionar el nombre de la conexiónconnection-name. 

    %%sm_sql --metastore-type GLUE_CONNECTION --metastore-id connection-name

    Utilice las funciones del SQL editor que aparecen a continuación para crear sus SQL consultas y, a continuación, ejecute la consulta ejecutando la celda. Para obtener más información sobre las capacidades de SQL ejecución, consulteSQLcaracterísticas de ejecución de la extensión JupyterLab SQL.

  • Lista desplegable de resultados de la consulta: puede especificar cómo representar los resultados de la consulta seleccionando un tipo de resultado en el menú desplegable situado junto al menú desplegable de selección de conexiones. Elige entre las dos alternativas siguientes:

    • Salida de celda: (predeterminada) Esta opción muestra el resultado de la consulta en el área de salida de celdas del cuaderno.

    • Marco de datos de Pandas: esta opción rellena un pandas DataFrame con los resultados de la consulta. Un cuadro de entrada adicional te permite ponerle un nombre DataFrame cuando eliges esta opción.

  • SQLsintaxis resaltada: la celda distingue automáticamente y de forma visual las SQL palabras clave, las cláusulas, los operadores y mucho más mediante el color y el estilo. Esto facilita la lectura y la comprensión del SQL código. Las palabras claveSELECT, comoFROM,WHERE, y las funciones integradas, como SUM yCOUNT, o las cláusulas, como GROUP BY y más, se resaltan con un color diferente y en negrita.

  • SQLformato: puede aplicar guiones, mayúsculas, espaciados y saltos de línea consistentes para agrupar o separar SQL declaraciones y cláusulas de una de las siguientes maneras. Esto facilita la lectura y la comprensión del SQL código.

    • Haga clic con el botón derecho en la SQL celda y seleccione Formato SQL.

    • Cuando la SQL celda esté enfocada, usa el atajo ALT+ F en Windows o la opción + F en macOS.

  • SQLfinalización automática: la extensión proporciona sugerencias automáticas y completa SQL palabras clave, funciones, nombres de tablas, nombres de columnas y más a medida que escribes. Cuando empiezas a escribir una SQL palabra clave como SELECT oWHERE, la extensión muestra una ventana emergente con sugerencias para completar automáticamente el resto de la palabra. Por ejemplo, al escribir nombres de tablas o columnas, sugiere que coincidan con los nombres de tablas y columnas definidos en el esquema de la base de datos.

    importante

    Para habilitar el SQL autocompletado en los JupyterLab cuadernos, los usuarios de la imagen de SageMaker distribución versión 1.6 deben ejecutar el siguiente npm install -g vscode-jsonrpc sql-language-server comando en un terminal. Una vez completada la instalación, reinicie el JupyterLab servidor ejecutándolo. restart-jupyter-server

    Para los usuarios de las versiones 1.7 y posteriores de imágenes de SageMaker distribución, no es necesario realizar ninguna acción.

    La celda ofrece dos métodos para completar automáticamente las SQL palabras clave reconocidas:

    • Invocación explícita (recomendada): pulse la tecla Tab para iniciar el menú de sugerencias contextual y, a continuación, pulse Entrar para aceptar el elemento sugerido.

    • Sugerencias continuas: la celda sugiere automáticamente las terminaciones a medida que escribes.

    nota

    • La función de autocompletar solo se activa si las SQL palabras clave están en mayúsculas. Por ejemplo, si se introduce SEL un mensaje paraSELECT, pero no se escribesel.

    • La primera vez que se conecta a una fuente de datos, la SQL finalización automática indexa los metadatos de la fuente de datos. Este proceso de indexación puede tardar algún tiempo en completarse en función del tamaño de las bases de datos.