Trechos de consulta

Muitas vezes é mais fácil duplicar e modificar trabalhos anteriores do que escrever algo do zero. Isto é particularmente verdadeiro para instruções JOIN comuns ou expressões CASE complexas. À medida que sua lista de query aumenta, pode ser difícil lembrar qual query contém a instrução necessária. Você também pode criar um snippet query que contenha um ponto de inserção com texto de espaço reservado que um usuário pode substituir em tempo de execução.

snippets query são segmentos de query que você pode compartilhar e acionar usando o preenchimento automático. Use snippets query 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}

Crie snippets de consulta

Use os seguintes passos para criar snippets usando estes exemplos de snippet:

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

  2. Clique na tab Desenvolvedor .

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

  4. Clique em Criar snippet query .

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

  6. Opcionalmente, insira uma descrição.

  7. No campo Fragmento , insira o fragmento.

  8. Clique em Criar.

    trecho query

Usar um snippet de consulta em uma consulta

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

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

Use os seguintes passos para usar um snippet query com esta query:

  1. Abra o Editor SQL.

  2. Digite sua query no painel query do editor SQL.

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

    query selecionando um snippet
  4. Execute a query com a cláusula WHERE do snippet query .

    query mostrando um snippet usado em uma query

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

Você designa pontos de inserção agrupando uma ordem tab inteira com um único cifrão e chaves ${}. Um espaço reservado para texto precedido por dois pontos :é opcional, mas útil para usuários não familiarizados com seu snippet. Nos fragmentos query 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 default para o espaço reservado que pode ser substituído no tempo de execução. Quando o Databricks SQL renderiza o snippet, o cifrão $ e as chaves {} são removidos e a palavra value ou o default 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 para o próximo valor. Ao pressionar Tab novamente, o quilate 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 de zero ${0} é sempre o último ponto na ordem tab .

Use os seguintes passos para usar os snippets query do ponto de inserção com a query:

  1. Abra o Editor SQL.

  2. Digite sua query no painel query do editor SQL.

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

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

    <span translate=query usando snippet query de ponto de inserção sem valor default" src="../../../_images/query-with-insertion-point.png" />
  4. Insira um valor para a cláusula WHERE , como 200.

  5. Opcionalmente, execute a query com a cláusula WHERE do snippet query .

  6. Repita os passos anteriores, mas selecione o snippet query com o ponto de inserção usando um valor default .

    <span translate=query usando o snippet query do ponto de inserção contendo um valor default" src="../../../_images/query-with-insertion-point-with-default-value.png" />
  7. Repita os passos anteriores, mas selecione o snippet query com vários pontos de inserção.

    query usando snippet query de ponto de inserção contendo vários pontos de inserção
  8. Insira um valor para o primeiro ponto de inserção, tab até o próximo ponto de inserção e insira um valor e, em seguida, tab até o ponto de inserção final e insira um valor.