Trechos de consulta

Muitas vezes, é mais fácil duplicar trabalhos anteriores e modificar do que escrever algo do zero. Isto é particularmente verdadeiro para declarações JOIN comuns ou expressões CASE complexas. À medida que sua lista de consultas cresce, pode ser difícil lembrar quais consultas contêm a declaração que você precisa. Você também pode criar um trecho de consulta que contenha um ponto de inserção com texto de marcador de posição que um usuário pode substituir durante a execução.

Trechos de consulta são segmentos de consultas que você pode compartilhar e acionar usando o preenchimento automático. Use trechos de consulta para:

• Declarações JOIN frequentes
• Cláusulas complicadas como WITH ou CASE.
• Formatação condicional

Aqui estão exemplos de trechos:

--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}

Criar trechos de consulta

Você pode criar um trecho de consulta a partir do SQL, bloco de anotações ou editores de arquivos. Siga estes passos:

1. No novo editor SQL, clique no kebab menu e, em seguida, clique em Exibir.

   No bloco de anotações ou editores de arquivos, clique em Exibir.

2. Clique em Trechos de consulta.

3. Clique Criar trecho de consulta.

4. No campo Substituir, insira o nome do trecho. Você usará esse nome ao escrever uma consulta que use o trecho.

5. (Opcional) Insira uma descrição.

6. No campo Trecho, insira o trecho.

7. Clique Criar.

   

Usar um trecho de consulta

Fragmentos de consulta podem ser usados em qualquer consulta SQL. Você pode acessar trechos de consulta no editor SQL, células SQL do bloco de anotações, arquivos SQL e consultas de painel de IA/BI.

Aqui está um exemplo de uma consulta simples com a qual você pode usar esses trechos de consulta:

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

Use as seguintes etapas para usar um trecho de consulta com essa consulta:

1. Abra Editor de SQL.

2. Digite sua consulta no painel de consulta do editor SQL.

3. Comece a digitar o nome do trecho de consulta e selecione-o na janela de preenchimento automático.

   No editor SQL, você também pode abrir manualmente a janela com Control+Space e selecionar um trecho.

   

4. Execute a consulta com a cláusula WHERE do trecho de consulta.

   

Trabalhando com pontos de inserção em fragmentos de consulta

Você designa pontos de inserção envolvendo uma ordem de tabulação numérica com um único cifrão e chaves ${}. Um marcador de texto precedido por dois pontos :é opcional, mas útil para utilizadores não familiarizados com o seu fragmento. Nos trechos de consulta com pontos de inserção que você criou anteriormente, ${1:value} é um ponto de inserção com um espaço reservado e ${1:100} é um ponto de inserção com um valor padrão para o espaço reservado que você pode substituir em tempo de execução. Quando o Databricks SQL renderiza o trecho de código, o cifrão $ e as chaves {} são removidas, e a palavra value ou o padrão 100 é realçado para substituição.

Quando há vários pontos de inserção, o cursor de inserção de texto salta para o primeiro ponto de inserção para solicitar o valor desejado. Quando você pressiona Tab, o cursor salta para o próximo ponto de inserção para o próximo valor. Quando você pressionar Tab novamente, o cursor saltará para a próxima linha do ponto de inserção até atingir o ponto de inserção final.

Observação

Um ponto de inserção com o valor zero ${0} é sempre o último ponto na ordem de tabulação.

Use as seguintes etapas para usar os trechos de consulta de ponto de inserção com a consulta:

1. Abra Editor de SQL.

2. Digite sua consulta no painel de consulta do editor SQL.

3. Digite as três primeiras letras do nome do trecho de consulta e selecione um trecho de consulta com o ponto de inserção sem um valor padrão.

   O trecho de consulta é adicionado à consulta e o cursor de inserção de texto salta para o ponto de inserção.

   

4. Insira um valor para a cláusula WHERE, como 200.

5. Opcionalmente, execute a consulta com a WHERE cláusula do trecho de consulta.

6. Repita as etapas anteriores, mas selecione o trecho de consulta com o ponto de inserção usando um valor padrão.

   

7. Repita as etapas anteriores, mas selecione o trecho de consulta com vários pontos de inserção.

   

8. Introduza um valor para o primeiro ponto de inserção, prima a Tecla de Tabulação para o ponto de inserção seguinte, introduza um valor e, em seguida, prima a Tecla de Tabulação para o ponto de inserção final e introduza um valor.