Mandato EXPORT utilizando el procedimiento ADMIN_CMD

Autorización

Conexión necesaria

Base de datos. El acceso del programa de utilidad a servidores de bases de datos Linux, UNIX o Windows desde clientes Linux, UNIX o Windows debe ser una conexión directa a través del motor. El acceso no debe ser una conexión directa a través de una pasarela Db2 Connect o un entorno de bucle.

Sintaxis del mandato

lista-orden-transversal

Parámetros del mandato

TO nombrearchivo

Especifica el nombre del archivo al que hay que exportar datos en el servidor. Este parámetro debe ser una vía de acceso completa y debe existir en la partición coordinadora del servidor.

Si se especifica el nombre un archivo que existe, el programa de utilidad de exportación sobrescribe el contenido del archivo; no añade la información.

Con o sin la cláusula, el ID de usuario delimitado debe tener la autoridad para crear archivos bajo el directorio indicado por la variable de registro DB2_UTIL_MSGPATH, así como el directorio donde se van a exportar los datos.

OF tipoarchivo

Especifica el formato de los datos del archivo de salida:

• DEL (formato ASCII delimitado), que es utilizado por gestor de bases de datos y distintos gestores de archivos.
• IXF (Integration Exchange Format, versión PC) es un formato binario con propietario.

LOBS TO vía-lob

Especifica una o más vías de acceso a los directorios en los que deben almacenarse los archivos LOB. La vía (o vías) debe existir en la partición coordinadora del servidor y debe estar totalmente calificada. Debe haber, al menos, un archivo por vía de acceso de LOB, y cada archivo debe contener al menos un LOB. El número máximo de vías de acceso que se puede especificar es 999. Este valor activa de forma implícita el comportamiento de LOBSINFILE.

LOBFILE nombrearchivo

Especifica uno o más nombres de archivo base para los archivos LOB. Cuando se ha agotado el espacio de nombres para el primer nombre, se utiliza el segundo nombre y así sucesivamente. Este valor activa de forma implícita el comportamiento de LOBSINFILE.

Cuando se crean archivos LOB durante una operación de exportación, los nombres de archivo se crean añadiendo el nombre base actual de esta lista a la vía de acceso actual (de lob-path). A continuación, debe añadir un número de secuencia de 3 dígitos y el identificador de tres caracteres lob. Por ejemplo, si la vía de acceso LOB actual es el directorio /u/foo/lob/path/ y el nombre de archivo LOB actual es bar, los archivos LOB que se crean son /u/foo/lob/path/bar.001.lob, /u/foo/lob/path/bar.002.lob y, así, sucesivamente. El número de secuencia de 3 dígitos en el nombre de archivo LOB crece a 4 dígitos después de utilizarse el 999, el número de 4 dígitos crece a 5 dígitos cuando se utiliza el 9999 y, así, sucesivamente.

XML TO vía-xml

Especifica una o más vías de acceso a los directorios en los que deben almacenarse los archivos XML. Hay, al menos, un archivo por vía de acceso XML, y cada archivo contiene al menos una instancia de modelo de datos XQuery (XDM). Si se especifica más de una vía de acceso, las instancias de XDM se distribuyen uniformemente entre las vías de acceso.

XMLFILE nombrearchivo

Especifica uno o más nombres de archivo base para los archivos XML. Cuando se ha agotado el espacio de nombres para el primer nombre, se utiliza el segundo nombre y así sucesivamente.

Al crear archivos XML durante una operación de exportación, los nombres de archivo se crean añadiendo el nombre base actual de esta lista a la vía de acceso actual (de xml-path). A continuación, debe añadir un número de secuencia de 3 dígitos y el identificador de tres caracteres xml. Por ejemplo, si la vía de acceso de XML actual es el directorio /u/foo/xml/path/ y el nombre de archivo XML actual es bar, los archivos XML que se han creado son /u/foo/xml/path/bar.001.xml, /u/foo/xml/path/bar.002.xml y, así, sucesivamente.

MODIFIED BY mod-tipoarchivo

Especifica opciones de modificador de tipo de archivo. Consulte Modificadores de tipo de archivo para el programa de utilidad de exportación.

XMLSAVESCHEMA

Especifica que la información del esquema XML se debe guardar para todas las columnas XML. Para cada documento XML exportado que se haya validado con un esquema XML cuando se insertó, el identificador de SQL completo de dicho esquema se almacena como un atributo (SCH) dentro del especificador de datos XML (XDS) correspondiente. Si el documento exportado no se ha validado con respecto a un esquema XML, no se incluirá un atributo SCH en el correspondiente XDS.

Las partes de esquema y nombre del identificador SQL se almacenan como valores "OBJECTSCHEMA" y "OBJECTNAME" en la fila de la tabla de catálogo SYSCAT.XSROBJECTS correspondiente al esquema XML.

La opción XMLSAVESCHEMA no es compatible con las secuencias XQuery que no producen documentos XML bien formados.

METHOD N nombre-columna

Especifica uno o más nombres de columna que se deben utilizar en el archivo de salida. Si no se especifica este parámetro, se utilizan los nombres de columna de la tabla. Este parámetro solo es válido para archivos IXF, pero no es válido cuando se exportan datos jerárquicos.

sentencia-select

Especifica la sentencia SELECT o XQUERY que devuelve los datos que se van a exportar. Si la sentencia provoca un error, se grabará un mensaje en el archivo de mensajes (o en la salida estándar). Si el código de error es uno de SQL0012W, SQL0347W, SQL0360W, SQL0437W o SQL1824W, la operación de exportación continuará; de lo contrario, se detendrá.

Si la sentencia SELECT se especifica como SELECT * FROM nombre_tabla y la tabla contiene columnas ocultas implícitamente, debe especificar explícitamente si los datos para las columnas ocultas han de incluirse en la operación de exportación. Utilice uno de los métodos siguientes para indicar si se incluyen los datos para columnas ocultas:

• Utilice uno de los modificadores de tipo de archivo de columnas ocultas: especifique implicitlyhiddeninclude cuando la exportación contenga datos para las columnas ocultas o especifique implicitlyhiddenmissing cuando la exportación no los contenga.

  db2 export to t.del of del modified by implicitlyhiddeninclude
     select * from t

• Utilice la variable de registro DB2_DMU_DEFAULT en el lado del cliente para establecer el comportamiento por omisión que ha de aplicarse cuando los programas de utilidad de movimiento de datos detecten tablas con columnas ocultas implícitamente.

  db2set DB2_DMU_DEFAULT=IMPLICITLYHIDDENINCLUDE
  db2 export to t.del of del select * from t 

HIERARCHY STARTING nombre-subtabla

Mediante el uso del orden transversal por omisión (orden OUTER para archivos ASC o DEL, o el orden almacenado en archivos de datos PC/IXF), exporte una subjerarquía empezando por sub-table-name.

HIERARCHY lista-orden-transversal

Exporte una subjerarquía utilizando el orden transversal especificado. Todas las subtablas deben listarse de modo PRE-ORDER. El primer nombre de subtabla se utiliza como nombre de tabla de destino para la sentencia SELECT.

MESSAGES ON SERVER

Especifica que se va a guardar el archivo de mensaje que se ha creado en el servidor mediante el mandato EXPORT. El conjunto de resultados devuelto incluye las dos columnas siguientes: MSG_RETRIEVAL y MSG_REMOVAL. MSG_RETRIEVAL es la sentencia SQL que es necesaria para recuperar todos los mensajes de aviso y error que se producen durante esta operación. MSG_REMOVAL es la sentencia SQL que es necesaria para borrar los mensajes.

Si esta cláusula no se especifica, se suprime el archivo de mensaje cuando ADMIN_CMD devuelve un resultado al interlocutor. La columna MSG_RETRIEVAL y MSG_REMOVAL del conjunto de resultados contiene valores nulos.

Con o sin la cláusula, el ID de usuario delimitado, o el grupo primario del propietario de la instancia, debe tener la autoridad para crear archivos bajo el directorio indicado por la variable de registro DB2_UTIL_MSGPATH, así como el directorio donde se van a exportar los datos.

Ejemplo

CALL SYSPROC.ADMIN_CMD ('EXPORT to /home/user1/data/myfile.ixf 
   OF ixf MESSAGES ON SERVER select * from staff')

Notas de uso

• Cualquier vía de acceso que se utiliza en el mandato EXPORT debe ser una vía de acceso completa válida en el servidor.
• Si una tabla contiene columnas LOB, al menos, se debe especificar una vía de acceso de LOB completa y un nombre de LOB, utilizando las cláusulas LOBS TO y LOBFILE.
• El programa de utilidad de exportación emite una sentencia COMMIT al principio de la operación, que con conexiones de tipo 2, provoca que el procedimiento devuelva SQL30090N con el código de razón 2.
• Al exportar de una base de datos UCS-2 a un archivo ASCII (DEL) delimitado, todos los datos de carácter se convierten a la página de códigos que está en vigor donde se ejecuta el procedimiento. Los datos de tipo serie y los de tipo gráfico se convierten a la misma página de códigos SBCS o MBCS del servidor.
• Asegúrese de completar todas las operaciones de tabla y liberar todos los bloqueos antes de iniciar una operación de exportación. Este paso se puede realizar emitiendo una sentencia COMMIT después de cerrar todos los cursores abiertos WITH HOLD, o emitiendo ROLLBACK.
• Se pueden utilizar alias de tabla en la sentencia SELECT.
• Es posible que aparezca el mensaje SQL27981W cuando no parezca que sea aplicable, como cuando la tabla EXPORT no está particionada. Puede pasar por alto este aviso con seguridad en este caso. Es posible que se devuelva este mensaje de aviso si la sentencia SELECT del mandato EXPORT incluye la palabra ' from ' antes de la palabra clave FROM de SQL.
• Los mensajes que se colocan en el archivo de mensaje incluyen la información devuelva del servicio de recuperación de mensajes. Cada mensaje empieza en una línea nueva.
• La importación PC/IXF se debe utilizar para trasladar datos entre bases de datos. Si los datos de caracteres que contienen separadores de fila se exportan a un archivo ASCII (DEL) delimitado y son procesados por un programa de transferencia de texto, los campos que contienen los separadores de fila se reducen o se amplían.
• El paso de copia de archivo no es necesario si se puede acceder a las bases de datos fuente y destino desde el mismo cliente.
• Db2 Connect se puede utilizar para exportar tablas de servidores DRDA como, por ejemplo, Db2 para z/OS, Db2 para VM y VSE, y Db2 para OS/400. Sólo se soporta la exportación PC/IXF.
• Al exportar al formato IXF, si los identificadores exceden el tamaño máximo soportado por el formato IXF, la exportación se realiza correctamente. Sin embargo, el archivo de datos resultante no puede ser utilizado por una operación de importación posterior utilizando la modalidad CREATE (SQL27984W).
• Al exportar al formato IXF, el programa de utilidad de exportación no mantiene los metadatos de tabla organizado por columnas que son necesarios para volver a crear la tabla organizado por columnas durante una operación de importación posterior utilizando la modalidad CREATE.
• Al exportar a un disquete en Windows y si la tabla que tiene más datos que la capacidad de un solo disquete, el sistema solicita otro disquete. Se generan archivos PC/IXF de varias partes (también conocidos como archivos PC/IXF de varios volúmenes, o archivos PC/IXF de división lógica) y se almacenan en disquetes separadas. En cada archivo, con la excepción del último, hay un registro CONTINUATION RECORD escrita de Db2 (o un registro "AC" de forma abreviada). Este registro indica que los archivos se dividen de forma lógica y muestra dónde buscar el siguiente archivo. Los archivos se pueden transferir a un sistema AIX para que los lean los programas de utilidad de importación y carga. El programa de utilidad de exportación no creará archivos PC/IXF de múltiples componentes cuando se invoque desde un sistema AIX. Para ver detalles sobre el uso, consulte el mandato IMPORT o el mandato LOAD.
• El programa de utilidad de exportación almacena el atributo NOT NULL WITH DEFAULT de la tabla en un archivo IXF, si la sentencia SELECT proporcionada tiene el formato SELECT * FROM nombre_tabla.
• Cuando se exportan tablas con tipo, las sentencias de subselección solo se pueden expresar especificando el nombre de tabla de destino y la cláusula WHERE. No se puede seleccionar la selección completa y select-statement cuando se exporta una jerarquía.
• Para formatos de archivo distintos a IXF, se recomienda que especifique la lista de orden transversal. Esta lista indica a Db2 cómo atravesar la jerarquía y qué subtablas exportar. Si no se especifica dicha lista, se exportan todas las tablas de la jerarquía y el orden por omisión es el orden de OUTER. La alternativa es utilizar el orden por omisión, que es el orden proporcionado por la función OUTER.
• Utilice el mismo orden transversal durante una operación de importación. El programa de utilidad de carga no soporta la carga de jerarquías o de subjerarquías.
• Cuando se exportan datos de una tabla que tiene filas protegidas, las credenciales LBAC que ostenta el ID de autorización de sesión podrían limitar las filas que se han exportado. Si el ID de autorización de sesión no tiene acceso de lectura sobre las filas, no se exportarán. No se proporciona ningún código de error ni de aviso.
• Si las credenciales LBAC que ostenta el ID de autorización de sesión no permiten leer de una o varias columnas protegidas incluidas en la exportación, la exportación falla y se devuelve un error (SQLSTATE 42512).
• Al ejecutar programas de utilidad de movimiento de datos como, por ejemplo, export y db2move, el compilador de consultas podría determinar que la consulta subyacente se ejecuta de forma más eficaz en un MQT que la tabla o tablas base. En este caso, la consulta se ejecuta en un MQT con la renovación diferida, y el resultado de los programas de utilidad podrían no representar los datos de forma precisa en la tabla subyacente.
• Los paquetes de exportación se enlazan utilizando el formato DATETIME ISO. De esta forma, todos los valores de indicación de fecha y hora se convierten al formato ISO cuando se convierten a una representación de serie. Puesto que los paquetes de CLP se enlazan utilizando el formato DATETIME LOC (formato específico de entorno local), podría ver un comportamiento incoherente entre CLP y la exportación, si el formato CLP DATETIME es diferente del formato ISO. Por ejemplo, la sentencia SELECT siguiente podría devolver resultados esperados:

     db2 select col2 from tab1 where char(col2)='05/10/2005';
        COL2
        ----------
        05/10/2005
        05/10/2005
        05/10/2005
        3 registro(s) seleccionado(s).

  Pero un mandato de exportación que utiliza la misma cláusula select no lo hará:

     db2 export to test.del of del select col2 from test 
     where char(col2)='05/10/2005';
        Número de filas exportadas: 0

  Ahora, si se sustituye el formato de fecha LOCALE por el formato ISO, se producen los resultados previstos:

     db2 export to test.del of del select col2 from test
     where char(col2)='2005-05-10';
        Número de filas exportadas: 3

Información de conjunto de resultados

SELECT SQLCODE, MSG
   FROM TABLE (SYSPROC.ADMIN_GET_MSGS
   ('3203498_txu')) AS MSG

CALL SYSPROC.ADMIN_REMOVE_MSGS
   ('3203498_txu')

Modificadores de tipo de archivo para el programa de utilidad de exportación

   modified by chardel""

   modified by chardel''

   db2 "export to temp of del modified by coldel;
      select * from staff where dept = 20"

   db2 create table decimalTable ( c1 decimal( 31, 2 ) )
   db2 insert into decimalTable values ( 1.1 )
   
   db2 export to data of del select * from decimalTable
    
   db2 export to data of del modified by STRIPLZEROS 
      select * from decimalTable

   "AAAA/MM/DD HH:MM:SS.UUUUUU"

   db2 export to delfile2 of del
      modified by timestampformat="aaaa.mm.dd hh:mm tt"
      select * from schedule