Fragmentos de código de consulta

A menudo es más fácil duplicar el trabajo anterior y modificar que escribir algo desde cero. Esto es especialmente cierto para instrucciones comunes JOIN o expresiones complejas CASE . A medida que crece la lista de consultas, puede ser difícil recordar qué consultas contienen la instrucción que necesita. También puede crear un fragmento de código de consulta que contenga un punto de inserción con texto de marcador de posición que un usuario puede reemplazar en el momento del runtime.

Los fragmentos de código de consulta son segmentos de consultas que se pueden compartir y desencadenar mediante Autocompletar. Use fragmentos de código de consulta para:

• Declaraciones frecuentes JOIN
• Cláusulas complicadas como WITH o CASE.
• Formato condicional

Estos son ejemplos de fragmentos de código:

--Simple snippet
WHERE fare_amount > 100

--Snippet with an insertion point for a value to be provided at runtime
WHERE fare_amount > ${1:value}

--Snippet with an insertion point for a value to be provided at runtime and containing a default value
WHERE fare_amount > ${1:100}

--Snippet with multiple insertion points
WHERE fare_amount > ${2:min_value} AND fare_amount < ${1:max_value} AND trip_distance < ${0:max_distance}

Creación de fragmentos de código de consulta

Puede crear un fragmento de código de consulta a partir de los editores de archivos, cuadernos o SQL. Siga estos pasos:

1. En el nuevo editor de SQL, haga clic en el menú kebab y, a continuación, haga clic en Ver.

   En los editores de archivos o cuadernos, haga clic en Ver.

2. Haga clic en Consultar fragmentos de código.

3. Haga clic en Crear fragmento de código de consulta.

4. En el campo Reemplazar , escriba el nombre del fragmento de código. Usará este nombre al escribir una consulta que use el fragmento de código.

5. (Opcional) Escriba una descripción.

6. En el campo Fragmento de código, escriba el fragmento de código.

7. Haga clic en Crear.

   

Uso de un fragmento de código de consulta

Los fragmentos de código de consulta se pueden usar en cualquier consulta SQL. Puede acceder a fragmentos de código de consulta en el editor de SQL, las celdas SQL del cuaderno, los archivos SQL y las consultas del panel de IA/BI.

Este es un ejemplo de una consulta sencilla con la que puede usar estos fragmentos de código de consulta:

--Simple query
SELECT * FROM samples.nyctaxi.trips

Siga estos pasos para usar un fragmento de código de consulta con esta consulta:

1. Abra el Editor de SQL.

2. Escriba la consulta en el panel de consultas del editor de SQL.

3. Empiece a escribir el nombre del fragmento de código de consulta y selecciónelo en la ventana autocompletar.

   En el editor de SQL, también puede abrir manualmente la ventana con Control+Space y seleccionar un fragmento de código.

   

4. Ejecute la consulta con la WHERE cláusula del fragmento de código de consulta.

   

Trabajar con puntos de inserción en fragmentos de código de consulta

Para designar puntos de inserción, encapsule un orden de tabulación entero con un signo de dólar único y llaves ${}. Un marcador de posición de texto precedido por dos puntos :es opcional, pero útil para los usuarios que no están familiarizados con el fragmento de código. En los fragmentos de código de consulta con puntos de inserción que creó anteriormente, ${1:value} es un punto de inserción con un marcador de posición y ${1:100} es un punto de inserción con un valor predeterminado para el marcador de posición que puede invalidar en tiempo de ejecución. Cuando Databricks SQL representa el fragmento de código, el signo de dólar $ y las llaves {} se quitan y la palabra value o el valor predeterminado de 100 se resalta para su reemplazo.

Cuando hay varios puntos de inserción, el cursor de texto salta al primer punto de inserción para pedir el valor deseado. Al pulsar Tab, el cursor salta al siguiente punto de inserción para el siguiente valor. Cuando vuelva a pulsar Tab, el signo de intercalación saltará a la siguiente línea de punto de inserción hasta llegar al punto de inserción final.

Nota:

Un punto de inserción de cero ${0} siempre es el último punto del orden de tabulación.

Siga estos pasos para usar los fragmentos de código de consulta del punto de inserción con la consulta:

1. Abra el Editor de SQL.

2. Escriba la consulta en el panel de consultas del editor de SQL.

3. Escriba las tres primeras letras del nombre del fragmento de código de consulta y, a continuación, seleccione un fragmento de código de consulta con el punto de inserción sin un valor predeterminado.

   El fragmento de consulta se añade a la consulta y el cursor de inserción de texto salta al punto de inserción.

   

4. Escriba un valor para la WHERE cláusula , como 200.

5. Opcionalmente, ejecute la consulta con la WHERE cláusula del fragmento de código de consulta.

6. Repita los pasos anteriores, pero seleccione el fragmento de código de consulta con el punto de inserción mediante un valor predeterminado.

   

7. Repita los pasos anteriores, pero seleccione el fragmento de código de consulta con varios puntos de inserción.

   

8. Escriba un valor para el primer punto de inserción, presione 'tab' para ir al siguiente punto de inserción y escriba un valor, luego presione 'tab' para ir al punto de inserción final y escriba un valor.