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
ouCASE
. - 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
O senhor pode criar um snippet de consulta nos editores SQL, Notebook ou arquivo. Siga estas etapas:
-
No editor SQL, clique no menu
kebab.
No novo editor SQL, clique no menu
kebab e, em seguida, clique em view .
No Notebook ou nos editores de arquivos, clique em visualizar .
-
Clique em Trechos de consulta .
-
Clique em Criar trecho de consulta .
-
No campo Substituir , insira o nome do trecho. Você usará esse nome ao escrever uma consulta que usa o trecho.
-
(Opcional) Insira uma descrição.
-
No campo Trecho , insira o trecho.
-
Clique em Criar .
Use um trecho de consulta
Os snippets de consulta podem ser usados em qualquer consulta SQL. O senhor pode acessar os snippets de consulta no editor SQL, nas células do Notebook SQL, nos arquivos SQL e nas consultas AI/BI dashboard.
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:
-
Abra o SQL Editor .
-
Digite sua consulta no painel de consulta do editor SQL.
-
Comece a digitar o nome do snippet de consulta e, em seguida, selecione-o na janela de preenchimento automático.
No editor SQL, o senhor também pode abrir manualmente a janela com
Control+Space
e selecionar um snippet. -
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 trechos de consulta com pontos de inserção que o senhor 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 default para o espaço reservado que o senhor pode substituir 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 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 do próximo valor. Quando você pressiona Tab
novamente, o cursor salta para a próxima linha do ponto de inserção até atingir o ponto de inserção final.
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:
-
Abra o SQL Editor .
-
Digite sua consulta no painel de consulta do editor SQL.
-
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 cursor de inserção de texto salta para o ponto de inserção.
-
Insira um valor para a cláusula
WHERE
, como200
. -
Opcionalmente, execute a consulta com a cláusula
WHERE
do snippet da consulta. -
Repita as etapas anteriores, mas selecione o snippet de consulta com o ponto de inserção usando um valor default.
-
Repita as etapas anteriores, mas selecione o trecho de consulta com vários pontos de inserção.
-
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.