Trechos de consulta

Geralmente, é mais fácil duplicar trabalhos anteriores e modificar do que escrever algo do zero. Isso é 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 de que você precisa. Você também pode criar um trecho de consulta que contém um ponto de inserção com texto de espaço reservado que um usuário pode substituir em tempo de 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 frequentes do JOIN
• Cláusulas complicadas como WITH ou CASE.
• Formatação condicional

Aqui estão alguns 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}

Crie trechos de consulta

Use as etapas a seguir para criar trechos usando esses exemplos de trechos:

1. Clique em seu nome de usuário na barra superior do workspace e selecione Settings (Configurações) no menu suspenso.

2. Clique em Developer tab.

3. Ao lado de SQL query snippets , clique em gerenciar .

4. Clique em Criar trecho de consulta .

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

6. Opcionalmente, insira uma descrição.

7. No campo Trecho , insira o trecho.

8. Clique em Criar .

   

Use um trecho de consulta em uma consulta

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 etapas a seguir para usar um trecho de consulta com essa consulta:

1. Abra o SQL Editor .

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

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

   

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

   

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

O senhor designa os pontos de inserção envolvendo um número inteiro tab order com um único cifrão e chaves ${}. Um espaço reservado para texto precedido por dois pontos :é opcional, mas útil para usuários que não estão familiarizados com seu trecho. Nos snippets de consulta com pontos de inserção que o senhor criou anteriormente, ${1:value} é um ponto de inserção com placeholder e ${1:100} é um ponto de inserção com um valor default para o placeholder que pode ser substituído em tempo de execução. Quando o site Databricks SQL renderiza o snippet, o cifrão $ e as chaves {} são removidos e a palavra value ou o default de 100 é destacado para substituição.

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

nota

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

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

1. Abra o SQL Editor .

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

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

   O trecho de consulta é adicionado à consulta e o quilate 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 cláusula WHERE do trecho de consulta.

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

   

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

   

8. Digite um valor para o primeiro ponto de inserção, tab para o próximo ponto de inserção e digite um valor e, em seguida, tab para o ponto de inserção final e digite um valor.