Compartir a través de

Instrucciones SQL de formato personalizado

Importante

Esta característica está en versión preliminar pública.

En este artículo se explica cómo personalizar las opciones de formato automático de SQL en la interfaz de usuario de Azure Databricks.

Información general

El formato SQL mejora la legibilidad y el mantenimiento de las consultas. Al estandarizar la sangría, el uso de mayúsculas y minúsculas de palabras clave y otras preferencias estilísticas, una consulta con formato correcto es más fácil de comprender, depurar y compartir con su equipo.

En Azure Databricks, puede configurar opciones de formato mediante un .dbsql-formatter-config.json archivo guardado en el directorio principal del área de trabajo. Después de guardar el archivo, el código SQL se da formato automáticamente en función de sus preferencias al ejecutar o dar formato al código en el editor o en un cuaderno de SQL.

Cómo configurar las opciones de formato de SQL

Para configurar las opciones de formato sql personales:

  1. Haga clic en icono Área de trabajoWorkspace (Área de trabajo) en la barra lateral.
  2. Haga clic en Crear > archivo.
  3. Asigna al archivo el nombre .dbsql-formatter-config.json.
  4. Agregue sus configuraciones deseadas como pares de clave y valor en formato JSON. Consulte Opciones de formateador
  5. Para aplicar la configuración de formato más reciente, actualice la página.

Archivo de configuración de ejemplo

En el ejemplo siguiente se muestra una configuración válida .dbsql-formatter-config.json .

{
  "printWidth": 80,
  "indentationStyle": "spaces",
  "indentationWidth": 4,
  "keywordCasing": "uppercase",
  "shouldExpandExpressions": true
}

Opciones de formateador

En la tabla siguiente se enumeran las opciones de configuración admitidas.

Opción Nombre del archivo de configuración Valores permitidos Predeterminado Description
Ancho de impresión printWidth Cualquier entero >= 0 100 Establece el ancho de línea de destino para el código con formato.
Estilo de sangría indentationStyle 'spaces', 'tabs' 'spaces' Especifica si se deben usar espacios o tabulaciones para la sangría. Si se establece, indentationWidth se omite.
Ancho de sangría indentationWidth Entero de 0 a 99 2 Número de espacios usados cuando indentationStyle se establece en 'spaces'.
Mayúsculas y minúsculas de palabras clave keywordCasing 'uppercase', , 'lowercase', 'none' 'none' Controla el formato de las palabras clave de SQL. 'none' deja la capitalización sin cambios.
Uso de mayúsculas y minúsculas en el nombre de la función functionNameCasing 'uppercase', , 'lowercase', 'none' 'none' Controla el formato de los nombres de función SQL. 'none' deja la capitalización sin cambios.
Colocación de comas commaPosition 'beginning', 'end' 'end' Controla dónde se colocan comas en listas.
Saltos de línea entre instrucciones numNewLinesBetweenStatements Entero de 0 a 99 1 Número de nuevas líneas insertadas entre instrucciones.
Saltos de línea entre cláusulas numNewLinesBetweenClauses Entero de 0 a 99 0 Número de líneas nuevas insertadas entre cláusulas dentro de una declaración.
Expandir expresiones booleanas shouldExpandExpressions true, false true Expande expresiones booleanas en líneas independientes.
Expandir las instrucciones CASE shouldExpandCaseStatements true, false true Expande cada cláusula de una sentencia CASE a su propia línea.
Expandir listas IN shouldExpandInStatements true, false false Expande los elementos de las listas IN en líneas independientes.
Expandir condiciones BETWEEN shouldExpandBetweenConditions true, false false Expande las condiciones BETWEEN en líneas separadas.
Condiciones de interrupción JOIN shouldBreakOnJoinSections true, false true Rompe JOIN las condiciones en líneas independientes.
  • Last updated on