Com os parâmetros, você pode definir os valores para os filtros ou cálculos de uma consulta cada vez que ela for executada. Para permitir a consistência entre consultas, os donos do espaço de trabalho|workspace podem definir parâmetros para valores comuns em Configuração. Por exemplo, você pode compartilhar parâmetros para Current Fiscal Year, Entity, ou Region com várias consultas.
Com esses parâmetros compartilhados:
- Os colaboradores podem usar parâmetros comuns com valores definidos, além de adicionar parâmetros personalizados específicos à sua consulta.
- Os administradores podem bloquear um parâmetro com um valor específico para todas as instâncias, como definir Current Fiscal Year, para garantir uma análise consistente.
Configurar um parâmetro
Para permitir a consistência entre as consultas, configure um parâmetro para um valor comum.
Etapa 1. Criar o parâmetro
- Em Configuration , selecione a guia Parameters e clique em Create .
-
Digite o nome do parâmetro e clique em Criar.
Observação: O nome do parâmetro pode incluir caracteres alfanuméricos e sublinhados, mas não espaços ou outros caracteres especiais.
Etapa 2. Configurar os detalhes do parâmetro
- No painel Details, selecione o tipo de dados dos valores do parâmetro, como Text ou Integer.
-
Para fornecer uma lista definida de opções a serem escolhidas quando uma consulta for executada, ative Pick List e insira cada opção em sua própria linha.
Observação: Para um filtro de data ou registro de data e hora, insira cada opção no formato
AAAA-MM-dd. - Digite ou selecione o valor padrão do parâmetro.
- Para impedir que os colaboradores usem um valor diferente do padrão, selecione Locked.
- Clique em Aplicar.
Editar os detalhes de um parâmetro
Para editar os detalhes de um parâmetro, por exemplo, para ajustar a lista de opções ou bloquear o valor:
- Em Configuration , selecione o parâmetro na guia Parameters.
- No painel Details, edite o nome, o tipo de dados ou os valores do parâmetro, conforme necessário.
- Para impedir que os colaboradores usem um valor diferente do padrão, selecione Bloqueado.
- Clique em Aplicar.
Ao editar os detalhes do parâmetro, todas as alterações serão aplicadas na próxima execução ou atualização das consultas.
Aviso
Qualquer atualização importante em um parâmetro ativo - como alterar o nome SQL, selecionar um novo tipo de dados ou mudar um tipo de campo para a opção "seleção múltipla" - interromperá as consultas existentes e resultará em falha na conexão.
Por esse motivo, recomendamos que você remova o parâmetro global de todas as consultas dependentes antes de fazer uma alteração. Caso contrário, você precisará editar individualmente cada consulta no modo SQL para levar em conta o parâmetro alterado.
Excluir um parâmetro
Para remover um parâmetro de Configuração , selecione-o na guia Parâmetros e clique em Excluir .