Ao atualizar ou inserir colunas de banco de dados, você pode definir comportamentos diferentes para uma origem ausente, vazia ou inexistente.
Ao Inserir ou Atualizar dados em uma coluna de banco de dados conectando uma conversão que está definida como opcional no modelo de esquema, você talvez deseje considerar o comportamento dos possíveis estados de entrada de origem: Ausente, Vazio ou Inexistente. O comportamento pode ser padrão ou customizado ativando uma Política de Banco de Dados.
A tabela 1 define os estados de origem e o comportamento sem uma Política de Banco de Dados ativada.
As tabelas 2 e 3 definem o comportamento de ativação de uma Política de Banco de Dados para verificar o estado de origem e, em seguida, tomar uma ação configurada específica.
Estado de origem | Definição | Comportamento |
---|---|---|
Origem Ausente | O documento de entrada não contém o elemento de origem. | A coluna não será passada na instrução SQL enviada
para o servidor de banco de dados. O resultado é determinado pela definição da
coluna de destino no banco de dados:
|
Origem Vazia | O documento de entrada contém o elemento de origem, mas essa origem está vazia. | O broker passa o valor retornado por "getValue" para o elemento de origem como o valor de parâmetro para a coluna na instrução SQL enviada para o banco de dados. Por exemplo, um elemento do tipo Sequência retornará o valor Sequência vazio, portanto, a coluna de banco de dados de destino pode ser configurada com uma sequência vazia, ". |
Origem Inexistente | O documento de entrada contém a origem esperada e ela é inexistente. | O valor retornado por "getValue" é configurado como NULL. |
Ao Inserir dados em uma coluna de banco de dados, você pode ativar uma política de banco de dados em cada transformação mapeando um único valor de um elemento de origem. Isso permite que você escolha uma das ações a seguir para cada um dos estados de origem de entrada: Ausente, Vazio ou Inexistente.
Ações para o estado de origem | Comportamento |
---|---|
Excluir coluna da operação do banco de dados | Inserir o valor padrão do banco de dados para a coluna. A coluna é excluída da instrução SQL enviada para o banco de dados. Esta opção será ativada apenas se a coluna do banco de dados de destino tiver um valor padrão definido no modelo de banco de dados do arquivo .dbm associado. |
Inserir o valor Sequência vazio " | Esta opção será ativada apenas se a coluna de banco de dados de destino for definida como qualquer tipo de sequência de caracteres no modelo do banco de dados do arquivo .dbm associado. |
Configurar como NULL | Esta opção será ativada apenas se a coluna de banco de dados de destino for definida como anulável no modelo do banco de dados do arquivo .dbm associado. |
Lançar um erro de mapa | Produz um erro de mapa:
|
Ao atualizar dados em uma coluna de banco de dados, é possível ativar uma política de banco de dados em cada conversão mapeando um único valor de um elemento de origem. Isso permite que você escolha uma das ações a seguir para cada um dos estados de origem de entrada: Ausente, Vazio ou Inexistente.
Ações para o estado de origem | Comportamento |
---|---|
Excluir coluna da operação do banco de dados | A coluna é excluída da instrução SQL enviada para o banco de dados. O valor da coluna atualmente no banco de dados não é alterado. |
Configurar para o valor Sequência vazio " | Esta opção será ativada apenas se a coluna de banco de dados de destino for definida como um tipo de sequência de caracteres no modelo do banco de dados do arquivo .dbm associado. |
Configurar como NULL | Esta opção será ativada apenas se a coluna de banco de dados de destino for definida como anulável no modelo do banco de dados do arquivo .dbm associado. |
Lançar um erro de mapa | Produz um erro de mapa:
|