Snippets de consulta

Em geral, é mais fácil duplicar e modificar um trabalho anterior do que escrever algo do zero. Isso é particularmente verdadeiro para instruçõ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 instrução de que você precisa. Você também pode criar um snippet de consulta que contém um ponto de inserção com texto de espaço reservado que um usuário pode substituir no runtime.

Snippets de consulta são segmentos de consultas que você pode compartilhar e disparar usando preenchimento automático. Use os snippets de consulta para:

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

Estes são exemplos de snippets:

--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 snippets de consulta

Use as seguintes etapas para criar snippets usando estes exemplos de snippet:

1. Clique no seu nome de usuário na barra superior da área de trabalho e selecione Configurações no menu suspenso.

2. Selecione a guia Desenvolvedor.

3. Ao lado de Snippets de consulta SQL clique em Gerenciar.

4. Clique em Criar Snippet de consulta.

5. No campo Substituir, insira o nome do snippet. Você usará esse nome ao escrever uma consulta que usa o snippet.

6. Insira uma descrição opcionalmente.

7. No campo Snippet, insira o snippet.

8. Clique em Criar.

   

Usar um snippet de consulta em uma consulta

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

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

Use as seguintes etapas para usar um snippet de consulta com esta consulta:

1. Abra o Editor SQL.

2. Digite a consulta no painel de consultas do editor de SQL.

3. Digite as três primeiras letras do nome do snippet e selecione um snippet na janela de preenchimento automático. Você também pode abrir manualmente a janela pressionando Option + Space e selecionando um snippet.

   

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

   

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

Você designa pontos de inserção envolvendo uma ordem de tabulação de inteiro com um sinal de cifrão único e chaves ${}. Um espaço reservado de texto precedido por dois-pontos : é opcional, mas útil para usuários não familiarizados com o seu snippet. Nos snippets de consulta com pontos de inserção criados anteriormente, ${1:value} é um ponto de inserção com 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 no runtime. Quando o Databricks SQL renderiza o snippet, o sinal de cifrão $ e as chaves {}são retirados e a palavra value, ou o padrão de 100, é realçada para substituição.

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

Observação

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

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

1. Abra o Editor SQL.

2. Digite a consulta no painel de consultas do editor de SQL.

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

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

   

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

5. Como opção, execute a consulta com a cláusula WHERE do snippet de consulta.

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

   

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

   

8. Insira um valor para o primeiro ponto de inserção, com a tecla de tabulação vá até o próximo ponto de inserção e insira um valor e, em seguida, vá até o ponto de inserção final e insira um valor.