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.

NOTE
Na interface do usuário do Adobe Experience Platform, as consultas parametrizadas só são suportadas no nível principal dos modelos em linha. Isso significa que as consultas parametrizadas só funcionam quando usadas no template original. Os modelos filho devem ser um modelo estático e não podem ter parâmetros dinâmicos. Consulte a documentação de modelos integrados para saber mais.

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 ( Um ícone de alerta. ) aparece na seção Parâmetros de Consulta ao lado de qualquer campo de entrada Valor vazio.

NOTE
Se a consulta não usar parâmetros, você ainda poderá inserir parâmetros desnecessários no Editor de consultas. O Editor de consultas ignora todos os pares de valores chave desnecessários e não têm efeito na execução ou nos resultados da consulta.

O Editor de Consultas com uma consulta parametrizada e a seção Parâmetros de consulta realçada.

TIP
Altere as guias de Parâmetros de consulta para Console para exibir a saída do console da consulta.

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.

A exibição dos logs de consulta com o SQL de uma consulta com parâmetros realçada na seção de detalhes.

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.

TIP
O Serviço de consulta oferece suporte a instruções preparadas por meio do uso de consultas parametrizadas. Consulte o guia de sintaxe de instruções preparadas para obter mais informações sobre a sintaxe SQL envolvida.

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.

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb