ARCHIVO PREDETERMINADO

Válido para

DEFGEN

Descripción

Utilice el parámetro DEFSFILE para identificar el nombre del archivo en el que DEFGEN escribirá definiciones de datos. Por defecto, el archivo de definiciones de datos se escribe en el juego de caracteres del sistema operativo local. Puede cambiar el juego de caracteres con la opción CHARSET.

Valor por defecto

Ninguno

Sintaxis

DEFSFILE <file_name> [APPEND | PURGE] [CHARSET <character_set>] [FORMAT RELEASE <major>.<minor>]

<file_name>

Nombre de archivo relativo o totalmente cualificado. El archivo se crea al ejecutar DEFGEN.

APPEND

Indica a DEFGEN que escriba contenido nuevo (desde la ejecución actual) al final de cualquier contenido existente, si el archivo especificado ya existe. Si el archivo de definiciones ya existe, pero es de una versión anterior de Oracle GoldenGate, puede definir la opción FORMAT RELEASE en la misma versión que el archivo existente para evitar errores. De lo contrario, DEFGEN intentará agregar funciones de metadatos más recientes y finalizar de forma anormal. A continuación se muestran las restricciones al utilizar APPEND:

• Si el archivo de definiciones de datos existente tiene un formato anterior a Oracle GoldenGate 11.2.1, DEFGEN agrega las definiciones de tabla en el formato antiguo, donde los nombres de tabla y columna con caracteres especiales y multibyte no están soportados.

• Si el archivo de definiciones de datos existente tiene el formato más reciente introducido en la versión 11.2.1, DEFGEN agrega las definiciones de tabla en el juego de caracteres existente del archivo.

• Si el archivo existente es de la versión 11.2 o anterior, se escribió cuando DEFGEN no soporta nombres de objetos de tres partes y causará un error si los nuevos metadatos contienen nombres de tres partes. Puede especificar objetos de una base de datos de contenedores de Oracle si elimina la parte de contenedor o catálogo mediante el parámetro NOCATALOG en el archivo de parámetros DEFGEN.

PURGE

Indica a DEFGEN que depure el archivo especificado antes de escribir contenido nuevo de la ejecución actual. Al utilizar PURGE, puede sobrescribir un archivo de definiciones existente creado por una versión anterior de DEFGEN con metadatos más recientes que admitan funciones más recientes, como nombres de objetos de tres partes.

CHARSET <character_set>

Genera el archivo de definiciones en el juego de caracteres especificado. Sin CHARSET, se utiliza el juego de caracteres por defecto del sistema operativo. Si se especifica el modo APPEND para un archivo de definiciones de la versión 11.2.1 o posterior, se ignora CHARSET y se utiliza el juego de caracteres del archivo de definiciones existente.

FORMAT RELEASE <major.minor>

Especifica el formato de metadatos de las definiciones que envía DEFGEN al archivo de definiciones. Los metadatos indican al proceso del lector si los registros de archivos son de una versión que éste soporte. El formato de los metadatos depende de la versión del proceso de Oracle GoldenGate. Las versiones anteriores de Oracle GoldenGate contienen metadatos distintos a los de las más recientes. Utilice FORMAT cuando un proceso que sea de una versión anterior de Oracle GoldenGate utilice el archivo de definiciones que es la actual.

• FORMAT es una palabra clave necesaria.

• RELEASE especifica una versión de Oracle GoldenGate. <major> es el número del versión principal, y <minor> es el número del secundario. X.x debe reflejar una Versión actual o anterior disponible de manera generalizada (GA) de Oracle GoldenGate. Los valores válidos son de 9.0 a través del número de versión X.x de Oracle GoldenGate actual, por ejemplo, 11.2 o 12.1. (Si utiliza una versión de Oracle GoldenGate anterior a 9.0, especifique 9.0 o 9.5.)

  La versión se asigna a un nivel interno de compatibilidad adecuado mediante programación. El valor por defecto es la versión actual del proceso que escribe en esta pista. Tenga en cuenta que las versiones de RELEASE anteriores a 12.1 no soportan nombres de objeto de tres partes.

FORMAT RELEASE <major.minor>

Especifica el formato de metadatos de los datos que envía Extract a una pista, un archivo o (si se trata de una tarea remota) a otro proceso. Los metadatos indican al proceso del lector si los registros de datos son de una versión que éste soporte. El formato de los metadatos depende de la versión del proceso de Oracle GoldenGate. Las versiones anteriores de Oracle GoldenGate contienen metadatos distintos a los de las más recientes.

FORMAT RELEASE especifica una versión de Oracle GoldenGate. major es el número del versión principal, y minor es el número del secundario. X.x debe reflejar una versión actual o anterior disponible de manera generalizada (GA) de Oracle GoldenGate. Los valores válidos son de 11,1 a través del número de versión X.x de Oracle GoldenGate actual, por ejemplo, 11,2 o 12,1. La versión se asigna de forma programática al nivel de compatibilidad de formato de pista adecuado. El valor por defecto es la versión actual del proceso que escribe en esta pista. Nota: Las versiones de RELEASE anteriores a 12.1 no soportan nombres de objeto de tres partes.

Nota: Si se utilizan varias pistas en un único Extract, solo pueden coexistir las versiones RELEASE que son iguales.

Los siguientes valores están soportados para Oracle Database 12.2 y superior:

• Para Oracle Database 12.2 no CD B o superior con la compatibilidad definida en 12.1, está soportada FORMAT RELEASE 12.2 o superior.

• Para Oracle Database 12.2 no CD B o superior con la compatibilidad definida en 12.2, está soportada FORMAT RELEASE 12.2 o superior.

• Para Oracle Database 12.2 CDB/PDB o superior con la compatibilidad definida en 12.2, solo están soportados los valores FORMAT RELEASE 12.3 o superiores. Esto es debido al uso del deshacer local para la PDB, lo cual requiere aumentar la transacción ID con el número del PDB para garantizar que los ID de trx sean únicos.

Ejemplo

DEFSFILE ./dirdef/orcldef CHARSET ISO-8859-11 FORMAT RELEASE 11.2