Mandato wsschema

La herramienta de esquema se puede utilizar para visualizar el esquema de base de datos en forma de XML o para hacer coincidir el esquema XML con una base de datos existente.

La herramienta wsschema puede reflejarse en el esquema de base de datos actual, convirtiéndolo opcionalmente en una representación XML para realizar manipulaciones adicionales. La herramienta de esquema puede tomar una definición de esquema XML; calcular las diferencias entre el esquema de base de datos existente y el esquema XML y aplicar los cambios necesarios para hacer que la base de datos se corresponda con el esquema XML. El formato XML utilizado por la herramienta de esquema es un resumen de las diferencias en dialectos SQL utilizados por distintos proveedores. Además, la herramienta adapta automáticamente su SQL para satisfacer dependencias foráneas y, por lo tanto, es útil como una manera general de manipular los esquemas.

Sintaxis

La sintaxis del mandato es la siguiente:

[AIX][HP-UX][Linux][Solaris][z/OS]
wsschema.sh [parámetros][argumentos]
[IBM i]
wsschema [parámetros][argumentos]
[Windows]
wsschema.bat [parámetros][argumentos]

Emita el mandato desde el subdirectorio bin del directorio raíz_perfil.

Parámetros

La herramienta wsschema acepta el conjunto estándar de argumentos de la línea de mandatos definidos por la infraestructura de configuración, además de los siguientes:
  • -ignoreErrors/-i < true/t | false/>: Si se establece en false, se produce una excepción si la herramienta detecta errores de base de datos.

    El valor predeterminado es false.

  • -file/-f <stdout | archivo salida>: utilice esta opción para escribir un script SQL para las modificaciones de esquema planificadas, en lugar de comprometerlas a la base de datos.

    Cuando se utiliza con las acciones de exportación o reflejo, el archivo especificado se utiliza para grabar el XML de esquema exportado. Si el archivo nombra un recurso en la classpath, los datos se grabarán en ese recurso. Utilice stdout para grabar salida estándar. El valor predeterminado es stdout.

  • -openjpatables/-ot <true/t | false/f>: cuando se refleja el esquema, este parámetro determina si se debe reflejar en las tablas y secuencias cuyos nombres empiezan por OPENJPA_.

    Algunos componentes de OpenJPA pueden utilizar estas tablas y secuencias, como la fábrica de esquemas de tabla. Cuando se utilizan otras acciones, openjpaTables controla si estas tablas se pueden descartar. El valor predeterminado es false.

  • -dropTables/-dt < true/t | false/>: Cuando esta opción se establece en true, el esquema descarta las tablas que no se utilizan durante las acciones de retención y renovación.

    El valor predeterminado es true.

  • -dropSequences/-dsq < true/t | false/>: Si esta opción se establece en true, el esquema descarta las secuencias que no se utilizan durante las acciones de retención y renovación.

    El valor predeterminado es true.

  • -sequences/-sq <true/t | false/f>: este distintivo determina si se pueden manipular las secuencias.

    El valor predeterminado es true.

  • -indexes/-ix <true/t | false/f>: este distintivo determina si se pueden manipular los índices en las tablas existentes.

    El valor predeterminado es true.

  • -primaryKeys/-pk < true/t | false/>: Este distintivo determina si se pueden manipular las claves primarias en las tablas existentes.

    El valor predeterminado es true.

  • -foreignKeys/fk <true/t | false/f>: este distintivo determina si se pueden manipular las claves foráneas en las tablas existentes.

    El valor predeterminado es true.

  • -record/-r <true/t | false/f>: este distintivo permite o impide que se graben cambios de esquema mediante la herramienta de esquema en la fábrica de esquemas actual.

    Seleccione true para permitir que se graben cambios de esquema o false para impedir que se graben cambios de esquema. El valor predeterminado se establece en true.

  • -schemas/-s <lista de esquemas>: Indica una lista de nombres de esquemas y tablas a los que debe acceder OpenJPA al ejecutar la herramienta de esquema.

    Esto es el equivalente a establecer la propiedad openjpa.jdbc.Schemas para que se ejecute una vez.

    Importante: La herramienta de esquema acepta el distintivo -action/-a. Se pueden colocar múltiples acciones en una lista, separadas por comas. Las acciones disponibles son las siguientes:
    • add: es la acción predeterminada si no se especifica ninguna otra acción. Actualiza el esquema con los documentos XML proporcionados añadiendo tablas, columnas, índices y otros componentes. Esta acción nunca descarta ningún componente del esquema.
    • retain: esta acción mantiene todos los componentes del esquema en la definición XML proporcionada pero descarta el resto de la base de datos. Esta acción nunca añade componentes al esquema.
    • drop: descarta todos los componentes del esquema en el XML del esquema. Esta acción descarta las tablas solamente si estas tienen 0 columnas después de que se hayan descartado todas las columnas que se listan en el XML.
    • refresh: esta acción es equivalente a las funciones retain y add.
    • build: genera SQL para crear un esquema que coincida con el que aparece en el archivo XML proporcionado. A diferencia de la acción add, esta acción no tiene en cuenta el hecho de que es posible que parte del esquema definido en el archivo XML ya exista en la base de datos. Esta acción se utiliza normalmente con el distintivo -file/-f del parámetro para escribir un script SQL. Este script se puede utilizar posteriormente para volver a crear el esquema en el XML.
    • reflect: genera una representación XML del esquema de base de datos actual.
    • createDB: esta acción genera SQL para volver a crear la base de datos actual. Esta acción se utiliza normalmente con el distintivo -file/-f del parámetro para escribir un script SQL que se puede utilizar para volver a crear el esquema actual en una nueva base de datos.
    • dropDB: genera SQL para soltar la base de datos actual. Al igual que la acción createDB, se puede utilizar con el distintivo -file/-f del parámetro para escribir un script para descartar una base de datos en lugar de hacerlo manualmente.
    • import: importa la definición de esquema XML proporcionada en la fábrica de esquemas actual.
      Nota: Esta acción no tiene ningún efecto si la fábrica de esquemas no almacena un registro del esquema.
    • export: exporta la definición almacenada del esquema en la fábrica de esquemas actual en un archivo XML.
      Nota: Esto puede producir un archivo vacío si la fábrica de esquemas no almacena un registro del esquema.
    • deleteTableContents: esta acción implementa SQL para suprimir todas las filas de todas las tablas que encuentra OpenJPA.

Uso

La herramienta wsschema se utiliza para obtener un archivo XML que describe el esquema de la base de datos. Para generar un archivo de esquema XML:
  • Debe tener tablas de base de datos y configurada la conexión a la base de datos.
  • Ejecute la herramienta wsschema desde la línea de mandatos en el directorio ${raíz _ perfil}/bin.
  • La herramienta genera un archivo XML que describe el esquema de base de datos.
En la consola administrativa se registran mensajes y errores según se especifique en la configuración.

Ejemplos

Añadir los componentes necesarios del esquema a la base de datos para que coincida con el documento XML proporcionado sin descartar datos:

[AIX][HP-UX][Linux][Solaris][z/OS]
$
wsschema.sh targetSchema.xml
[IBM i]
$ wsschema targetSchema.xml
[Windows]
$ wsschema.bat targetSchema.xml

Repita la misma acción que en el ejemplo anterior, esta vez sin cambiar la base de datos en lugar de escribir los cambios planificados en un script SQL:

[AIX][HP-UX][Linux][Solaris][z/OS]
 wsschema.sh -f script.sql targetSchema.xml
[IBM i]
 wsschema -f script.sql targetSchema.xml
[Windows]
 wsschema.bat -f script.sql targetSchema.xml

Escriba un script SQL que recrea la base de datos actual:

[AIX][HP-UX][Linux][Solaris][z/OS]
$ wsschema.sh -a createDB -f script.sql
[IBM i]
$ wsschema -a createDB -f script.sql
[Windows]
$ wsschema.bat -a createDB -f script.sql

Renueve el esquema y suprima todo el contenido de todas las tablas que conoce OpenJPA:

[AIX][HP-UX][Linux][Solaris][z/OS]
$ wsschema.bat -a refresh,deleteTableContents
[IBM i]
$ wsschema -a refresh,deleteTableContents
[Windows]
$ wsschema.bat -a refresh,deleteTableContents

Descarte la base de datos actual:

[AIX][HP-UX][Linux][Solaris][z/OS]
$ wsschema.sh -a dropDB
[IBM i]
$ wsschema -a dropDB
[Windows]
$ wsschema.bat -a dropDB

Grabe una representación XML del esquema actual en el archivo schema.xml:

[AIX][HP-UX][Linux][Solaris][z/OS]
$ wsschema.sh -a reflect -f schema.xml
[IBM i]
$ wsschema -a reflect -f schema.xml
[Windows]
$ wsschema.bat -a reflect -f schema.xml

Información adicional

Para obtener más información, consulte la información de JDBC en la documentación de Apache OpenJPA.


Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rejb_wsschema
File name: rejb_wsschema.html