SETENV

Válido Para

Extrair e Replicar.

Todos os valores SETENV devem ser definidos antes de qualquer entrada USERIDALIAS, FETCHUSERIDALIAS, TRANLOGOPTIONS MININGUSER, MININGUSERIDALIAS nos arquivos de parâmetros.

Descrição

Use o parâmetro SETENV para definir um valor para uma variável de ambiente. Quando o processo Extract ou Replicat é iniciado, ele usa o valor especificado em vez do valor definido no ambiente do sistema operacional. Um conjunto de variáveis na instrução SETENV substitui qualquer variável existente definida no nível do sistema operacional. Use uma instrução SETENV por variável a ser definida.

Para extrações integradas, você pode definir novas variáveis de ambiente se elas estiverem disponíveis no servidor lcr. As novas variáveis de ambiente são:

• USERNAME: Nome do usuário de log-in no banco de dados

• OSUSERNAME: Nome do usuário do Sistema Operacional

• MACHINENAME: Nome do host, da máquina ou do servidor em que o banco de dados está sendo executado

• PROGRAMNAME: Nome do programa ou aplicativo que iniciou a transação ou a sessão

• CLIENTIDENTIFIER: Conjunto de valores usando DBMS_SESSION.set_identifier()

SETENV não pode ser usado com parâmetros de consulta.

Padrão

Nenhum

Sintaxe

SETENV (
{<environment_variable> | TZ}
= '<value>'
)

<environment_variable>

O nome da variável do ambiente a ser definida.

TZ

(Somente MySQL) Ao executar o Oracle GoldenGate for MySQL em um servidor Windows ou em um servidor Linux (para a versão do OGG inferior a 23.10.x), que está em um host remoto do servidor de banco de dados, use o parâmetro SETENV no arquivo de parâmetros Extract para definir o fuso horário correspondente ao do servidor de banco de dados. A seguir está o formato suportado de valores de fuso horário para a opção TZ:

SETENV(TZ='tzn [+|-]hh[:mm[:ss]][dzn]')

tzn - Three-letter time-zone name, such as PST. You must specify the correct offset from local time to UTC.
hh - Difference in hours between UTC and local time. Sign (+) optional for positive values.
mm - Minutes. Separated from hh by a colon (:).
ss - Seconds. Separated from mm by a colon (:).
dzn - Three-letter daylight-saving-time zone such as PDT.
If daylight saving time is never in effect in the locality, set TZ without a value for dzn. The C run-time
library assumes the United States' rules for implementing the calculation of daylight saving time (DST).

O deslocamento é positivo se o fuso horário local for oeste do Meridiano Principal e negativo se for Leste. A hora deve estar entre 0 e 24, e o minuto e os segundos entre 0 e 59.

<'value'>

Um valor para a variável especificada. Coloque o valor entre aspas simples.

Exemplos

Exemplo 1

O uso de instruções SETENV separadas permite que uma única instância do Oracle GoldenGate se conecte a várias instâncias do Oracle AI Database sem precisar alterar as definições do ambiente. As instruções de parâmetro a seguir definem um valor para ORACLE_HOME e ORACLE_SID.

SETENV (ORACLE_HOME = '/home/oracle/ora9/product')
SETENV (ORACLE_SID = 'ora9')

Exemplo 2

A instrução de parâmetro a seguir define o fuso horário de um Oracle GoldenGate para Extract MySQL como Horário Padrão do Pacífico, UTC ou IST com alternância automática de DST.

SETENV(TZ='PST8PDT')
For UTC, SETENV(TZ='UTC')
For IST, SETENV(TZ='IST-05:30')