Consultas parametrizadas parameterized-queries

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 Usuário do Editor de Consulta. 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 syntax

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 create

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, selecione a guia Parâmetros de consulta ao lado do Console e adicione o valor ausente para a chave. 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 campo de entrada Valor vazio.

Usar detalhes de logs de consulta para verificar valores de parâmetros check-parameter-values

Não é possível salvar parâmetros nos modelos, pois os valores usados não são persistentes. No entanto, você pode verificar a página Detalhes do log de consulta 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 localizar os valores usados.

Agendar uma consulta com parâmetros schedule

Os valores de parâmetro são salvos quando você agenda uma consulta com parâmetros. Para agendar uma consulta parametrizada, siga o processo típico para criar uma consulta agendada, conforme descrito no guia para criar um agendamento de consulta e, 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 definição de parâmetros para uma consulta parametrizada agendada 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 monitorando consultas agendadas para entender melhor o status de todos os trabalhos de consulta por meio da interface do usuário da Platform.