Consultas parametrizadas

O Serviço de consulta suporta o uso de consultas parametrizadas no Editor de consultas. Com consultas parametrizadas, agora é possível usar espaços reservados para parâmetros e adicionar os valores de parâmetro no tempo de execução. Os espaços reservados permitem trabalhar com dados dinâmicos em que você não sabe quais serão os valores até que a instrução seja executada. Você também pode preparar suas consultas antecipadamente e reutilizá-las para fins semelhantes. A reutilização de consultas economiza um esforço considerável, pois você evita criar consultas SQL distintas para cada caso de uso.

Pré-requisitos

Antes de continuar com este guia, leia o Guia da interface do Editor de consultas. O guia do Editor de consultas fornece informações detalhadas sobre como gravar, validar e executar consultas para dados de experiência do cliente na interface do usuário do Experience Platform.

Sintaxe de consulta com parâmetros

Consultas parametrizadas usam o formato '$YOUR_PARAMETER_NAME' e podem ser concatenadas usando a notação de pontos. Um exemplo de instrução SQL que usa consultas parametrizadas pode ser visto abaixo.

INSERT INTO
   $Database_Name.Schema_Name.adwh_lkup_process_delta_log
   (process_name, merge_policy_id, process_status, process_date, create_ts, change_ts)
SELECT
   '$Table_Process_Name' process_name,
   hash('$Merge_PolicyID') merge_policy_id,
   '$process_status' process_status,
   to_date('$date_key') process_date,
   CURRENT_TIMESTAMP create_ts,
   CURRENT_TIMESTAMP change_ts;

Criar uma consulta com parâmetros

Para criar sua consulta parametrizada na interface do usuário do, navegue até o Editor de consultas. Consulte a seção sobre acesso ao Editor de consultas para obter mais instruções.

Use o prefácio '$' para inserir um parâmetro na sua consulta no editor de texto. Em seguida, adicione o valor ausente para a chave no Parâmetros de consulta seção abaixo do editor. A consulta não pode ser executada se você não adicionar um valor a qualquer uma das chaves necessárias. Um ícone de alerta () aparece na seção Parâmetros de consulta ao lado de qualquer Valor campos de entrada.

Se você remover um parâmetro e tentar executar a consulta novamente após ela já ter sido executada, uma mensagem de erro será exibida na Parâmetros de consulta seção para alertá-lo.

Usar detalhes de logs de consulta para verificar valores de parâmetros

Não é possível salvar parâmetros nos modelos, pois os valores usados não são persistentes. No entanto, você pode verificar o Detalhes do log de consulta página para localizar os valores de parâmetro usados em uma execução de consulta. Nesse caso, os logs não indicam que a consulta era uma consulta com parâmetros. Consulte a documentação dos logs de consulta para obter instruções sobre como encontrar os valores usados.

Agendar uma consulta com parâmetros

Os valores de parâmetro são salvos quando você agenda uma consulta com parâmetros. Para programar uma consulta parametrizada, siga o processo normal para criar uma consulta programada, conforme descrito no guia para criar um agendamento de consulta, em seguida, insira os valores de parâmetro a serem usados na execução da consulta. Esta seção da interface só é exibida para consultas parametrizadas. Consulte a seção sobre definindo parâmetros para uma consulta parametrizada programada para obter instruções específicas.

Próximas etapas

Ao ler este documento, você aprendeu a parametrizar consultas na interface do usuário do Adobe Experience Platform e usá-las em execuções de consultas programadas. O documento também destacou como verificar os logs para os valores de parâmetro usados nas execuções de consulta.

Em seguida, é recomendável ler o guia em monitoramento de consultas programadas para obter uma melhor compreensão do status de todos os trabalhos de consulta por meio da interface do usuário da Platform.