Fragmentos de código de consulta

A menudo resulta más fácil duplicar el trabajo anterior y modificarlo que escribir algo desde cero. Esto es especialmente así en el caso de las instrucciones comunes JOIN o las expresiones CASE complejas. A medida que crece la lista de consultas, puede ser difícil recordar qué consultas contienen la instrucción que se 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:

• Instrucciones JOIN frecuentes
• 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}

Crear fragmentos de código de consulta

Siga estos pasos para crear fragmentos de código mediante estos ejemplos de fragmentos de código:

1. Haga clic en el nombre de usuario en la barra superior del área de trabajo y seleccione Configuración en la lista desplegable.

2. Haga clic en la pestaña Programador.

3. Junto a fragmentos de código de consulta SQL, haga clic en Administrar.

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

5. 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.

6. Si lo desea, escriba una descripción.

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

8. Haga clic en Crear.

   

Usar un fragmento de código de consulta en una consulta

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. Abrir Editor SQL.

2. Introduzca su consulta en el panel del editor SQL.

3. Escriba las tres primeras letras del nombre del fragmento de código y, a continuación, seleccione un fragmento de código en la ventana de autocompletar. También puede abrir manualmente la ventana presionando Option + Space y seleccionando un fragmento de código.

   

4. Ejecute la consulta con la cláusula WHERE 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 de dos puntos : es opcional, aunque resulta ú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 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 el momento del runtime. 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 carat de inserción de texto salta al primer punto de inserción para solicitar el valor deseado. Al presionar Tab, el carat salta al siguiente punto de inserción para el siguiente valor. Al presionar Tab de nuevo, el carat saltará a la siguiente línea de punto de inserción hasta que llegue 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. Abrir Editor SQL.

2. Introduzca su consulta en el panel del editor 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 código de consulta se agrega a la consulta y el carat de inserción de texto salta al punto de inserción.

   

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

5. Opcionalmente, ejecute la consulta con la cláusula WHERE 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 usando 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, vaya al siguiente punto de inserción y escriba un valor y, a continuación, vaya al último punto de inserción para escribir un valor.