Atualiza as propriedades de sessão para um conjunto de sessões de atendem às condições especificadas. É possível atualizar todas as sessões em uma pasta ou em uma lista de sessões. Para atualizar uma lista de sessões, crie um arquivo de entrada persistente. A lista pode conter uma lista específica de sessões ou conter condições, como um padrão de nome ou um valor de propriedade. Use ExecuteQuery para gerar um arquivo de entrada persistente.
Quando você executa MassUpdate, você pode visualizar informações, como o nome da pasta, o número de sessões atualizadas com êxito e os nomes das sessões que foram atualizadas. Você também pode visualizar o status da atualização na janela de linha de comando ou em um arquivo de log gerado pelo comando. Especifique o nome e o caminho do arquivo de log ao executar o comando. Por padrão, o arquivo de log é armazenado no diretório em que você executou o comando.
Use MassUpdate para atualizar uma propriedade de sessão em várias sessões quando uma versão do PowerCenter altera um valor padrão.
Não é possível atualizar as propriedades de sessão dependentes.
Antes de atualizar as sessões, você também pode executar MassUpdate em um modo de teste para visualizar as alterações. Para visualizar um arquivo de log de exemplo, consulte
Exemplo de arquivo de log.
O comando MassUpdate usa a seguinte sintaxe:
pmrep massupdate
-t <session_property_type (session_property, session_config_property, transformation_instance_attribute, session_instance_runtime_option)>
-n <session_property_name>
-v <session_property_value>
[-w <transformation_type>]
{-i <persistent_input_file> | -f <folder_name> }
[-o <condition_operator (equal, unequal, less, greater)>]
[-l <condition_value>]
[-g <update_session_instance_flag>]
[-m <test_mode>]
[-u <output_log_file_name>]
A tabela a seguir descreve as opções e argumentos do MassUpdate do
pmrep
:
| |
Obrigatório. Tipo de propriedade de sessão a ser atualizada. As propriedades de sessão têm os seguintes tipos:
transformation_instance_attribute
session_instance_runtime_option
|
| |
Obrigatório. Nome do atributo ou da propriedade a ser atualizada
|
| |
Obrigatório. Valor que você deseja atribuir à propriedade seguido por ponto-e-vírgula.
Por exemplo, para atribuir um valor para a propriedade, use a seguinte sintaxe: -v "IgnoreNULLInExpressionComparison=Yes; "
Coloque o valor da propriedade da sessão entre aspas duplas.
|
| |
Obrigatório se você atualizar um atributo de instância de transformação. Tipo de transformação a ser atualizada. É possível atualizar os seguintes tipos de transformação: agregador, unificador, procedimento de pesquisa, classificação, ordenador, definição de origem e definição de destino.
|
| |
Obrigatório se você não usar a opção -f. Nome do arquivo que contém a lista selecionada de sessões a serem atualizadas. Você pode usar o comando pmrep ExecuteQuery para executar uma consulta e gerar esse arquivo. MassUpdate retonará um erro se você especificar um objeto que não for uma sessão. Você deve usar a opção -i ou -f, mas não ambas.
|
| |
Obrigatório se você não usar a opção -i. Nome da pasta. Use para atualizar todas as sessões em uma pasta. Você deve usar a opção -i ou -f, mas não ambas.
|
| |
Obrigatório se você usar condition_value. Parte da condição que define o conjunto de sessões.
O atributo de uma sessão ou instância de sessão é atualizado quando a condição é atendida.
É possível usar os seguintes operadores de condição para atualizar uma cadeia de caracteres: igual ou desigual.
É possível usar os seguintes operadores de condição para atualizar um inteiro: igual, desigual, menor ou maior.
|
| |
Obrigatório se você usar um operador de condição. Parte da condição. A condição é exibida da seguinte forma:
<nome_da_propriedade_de_sessão> <operador_de_condição> <valor_da_condição>
|
|
update_session_instance_flag
|
Obrigatório se você atualizar uma opção de tempo de execução de instância da sessão.
Opcional para os seguintes tipos de propriedades de sessão: propriedade de sessão, atributo de configuração de sessão e atributo de instância de transformação.
Atualiza as instâncias de sessão.
Você poderá atualizar um atributo em uma instância de sessão se a instância de sessão substituir o atributo.
|
| |
Opcional. Executa MassUpdate no modo de teste. Exibe as sessões que sofrerão impacto pelo comando antes da confirmação das alterações. Você pode visualizar os seguintes detalhes na janela de linha de comando:
Tipo de sessão: reutilizável ou não reutilizável
Valor atual da propriedade de sessão
As sessões para as quais o atributo tem o mesmo valor não são afetadas pelo comando.
|
| |
Opcional. Nome do arquivo de log que armazena o status da atualização e as informações básicas sobre as sessões e as instâncias de sessão. Os valores de atributo anteriores também são gravados nesse arquivo. Se você não usar essa opção, os detalhes serão exibidos na janela de linha de comando.
|
O comando MassUpdate retorna a mensagem “massupdate concluído com êxito” ou “falha ao executar massupdate”. A atualização pode falhar pelos seguintes motivos:
Você não especificou um valor de atributo válido que pertence ao nome do atributo.
Você especificou o nome de propriedade de sessão correto mas com o tipo de propriedade de sessão incorreto.
Você não especificou a opção -v que termina com um ponto-e-vírgula ao atualizar um valor de propriedade de sessão.
Você não especificou a opção -w ao atualizar um atributo de instância de transformação.
Você não especificou a opção -g ao atualizar uma opção de tempo de execução da instância da sessão.
Você não tem a função Administrador dos Serviços de Repositório.
