Compartir a través de

Creación de archivos de script (AccessToSQL)

Antes de iniciar la aplicación de consola de SQL Server Migration Assistant (SSMA), cree el archivo de script. Si es necesario, cree el archivo de valores de variables y el archivo de conexión del servidor.

El archivo de script tiene tres secciones:

  1. config: establezca los parámetros de configuración para la aplicación de consola.

  2. servers: establezca las definiciones de servidor de origen y de destino. También puede colocar estas definiciones en un archivo de conexión de servidor independiente.

  3. script-commands: Ejecute comandos de flujo de trabajo de SSMA.

Cada sección se describe con detalle en las secciones siguientes:

Configuración de las opciones de la consola de acceso

El archivo de script de consola muestra las configuraciones de un script.

Si especifica cualquiera de los elementos del nodo de configuración, establezca la configuración global para todos los comandos de script. Para invalidar la configuración global, establezca estos elementos de configuración dentro de cada comando de la script-command sección .

Puede configurar las siguientes opciones:

  1. Proveedor de ventana de salida: si establece el atributo suppress-messages en true, la consola no muestra los mensajes específicos del comando. Los atributos son:

    • destination: especifica si la salida se imprime en un archivo o stdout. Este atributo es false de forma predeterminada.

    • file-name: ruta de acceso del archivo (opcional).

    • suppress-messages: suprime los mensajes en la consola. Este atributo es false de forma predeterminada.

    Ejemplo:

    <output-providers>
  <output-window
    suppress-messages="<true/false>"   (optional)
    destination="<file/stdout>"        (optional)
    file-name="<file-name>"            (optional)
   />
</output-providers>

    o

    <...All commands...>
  <output-window
     suppress-messages="<true/false>"   (optional)
     destination="<file/stdout>"        (optional)
     file-name="<file-name>"            (optional)
   />
</...All commands...>

  2. Proveedor de conexión de migración de datos: especifica qué servidor de origen o de destino se va a usar para la migración de datos. source-use-last-used indica que el último servidor de origen usado se usa para la migración de datos. Del mismo modo, target-use-last-used indica que el último servidor de destino usado se usa para la migración de datos. Use los source-server atributos o target-server para especificar el servidor.

    Solo puede usar uno de los atributos siguientes:

    • source-use-last-used="true" (valor predeterminado) o source-server="source_servername"
    • target-use-last-used="true" (valor predeterminado) o target-server="target_servername"

    Ejemplo:

    <output-providers>
  <data-migration-connection   source-use-last-used="true"
                               target-server="target_1"/>
</output-providers>

    o

    <migrate-data>
  <data-migration-connection   source-server="source_1"
                               target-use-last-used="true"/>
</migrate-data>

  3. Elemento emergente entrada de usuario: controla los errores cuando la consola carga objetos de la base de datos. El usuario proporciona los modos de entrada y, si se produce un error, la consola continúa como especifica el usuario.

    Los modos incluyen:

    • ask-user: indica al usuario que continúe (yes) o se produzca un error (no).
    • error: la consola muestra un error y detiene la ejecución.
    • continue: la consola continúa con la ejecución.

    El modo predeterminado es error.

    Ejemplo:

    <output-providers>
  <user-input-popup mode="<ask-user/continue/error>"/>
</output-providers>

    o

    <!-- Connect to target database -->
<connect-target-database server="target_0">
  <user-input-popup mode="<ask-user/continue/error>"/>
</connect-target-database>

  4. Proveedor de reconexión: establece la configuración de reconexión si hay errores de conexión. Establezca esta opción para los servidores de origen y de destino.

    Los modos de reconexión son:

    • reconnect-to-last-used-server: si la conexión no está activa, intenta volver a conectarse al último servidor usado como máximo cinco veces.
    • generate-an-error: si la conexión no está activa, el sistema genera un error.

    El modo predeterminado es generate-an-error.

    Ejemplo:

    <output-providers>
  <reconnect-manager on-source-reconnect="<reconnect-to-last-used-server/generate-an-error>"
                     on-target-reconnect="<reconnect-to-last-used-server/generate-an-error>"/>
</output-providers>

    o

    <!--synchronization-->
<synchronize-target>
  <reconnect-manager on-target-reconnect="reconnect-to-last-used-server"/>
</synchronize-target>

    o

    <!--data migration-->
<migrate-data server="target_0">
  <reconnect-manager
    on-source-reconnect="reconnect-to-last-used-server"
    on-target-reconnect="generate-an-error"/>
</migrate-data>

  5. Proveedor de sobrescritura del convertidor: use esta configuración para controlar los objetos que ya están presentes en la metabase de destino. Entre las posibles acciones se incluyen:

    • error: la consola muestra un error y detiene la ejecución.
    • overwrite: sobrescribe los valores de objeto existentes. Esta acción es la predeterminada.
    • skip: la consola omite los objetos que ya existen en la base de datos.
    • ask-user: solicita al usuario la entrada (yes o no).

    Ejemplo:

    <output-providers>
  <object-overwrite action="<error|skip|overwrite|ask-user>"/>
</output-providers>

    o

    <convert-schema object-name="ssma.TT1">
  <object-overwrite action="<error|skip|overwrite|ask-user>"/>
</convert-schema>

  6. Proveedor de requisitos previos con errores: use esta configuración para controlar los requisitos previos necesarios para procesar un comando. De forma predeterminada, strict-mode es false. Si lo establece en true, el sistema genera una excepción por no cumplir con los requisitos previos.

    Ejemplo:

    <output-providers>
  <prerequisites strict-mode="<true|false>"/>
</output-providers>

  7. Detener operación: para detener la operación durante la operación media, use el método abreviado de teclado Ctrl+C . La consola de SSMA espera a que se complete la operación y finalice la ejecución de la consola.

    Si desea detener la ejecución inmediatamente, presione de nuevo el método abreviado de teclado Ctrl+C para la terminación abrupta de la aplicación consola de SSMA.

  8. Proveedor de progreso: Informa del progreso de cada comando de consola. Este valor está deshabilitado de forma predeterminada. Los atributos de informes de progreso comprenden:

    • off
    • every-1%
    • every-2%
    • every-5%
    • every-10%
    • every-20%

    Ejemplo:

    <output-providers>
  <progress-reporting enable="<true|false>"           (optional)
                      report-messages="<true|false>"  (optional)
                      report-progress="every-1%|every-2%|every-5%|every-10%|every-20%|off" (optional)/>
</output-providers>

    o

    <...All commands...>
  <progress-reporting
    enable="<true|false>"              (optional)
    report-messages="<true|false>"     (optional)
    report-progress="every-1%|every-2%|every-5%|every-10%|every-20%|off"     (optional)/>
</...All commands...>

  9. Verbosidad del registrador: establece el nivel de verbosidad del registro. Esta configuración corresponde a la opción Todas las categorías de la interfaz de usuario. De forma predeterminada, el nivel de detalle del registro de eventos es error.

    Las opciones de nivel del registrador incluyen:

    • fatal-error: registra solo mensajes de error fatales.
    • error: registra solo mensajes de error y de error fatal.
    • warning: registra todos los niveles excepto los mensajes de depuración e información.
    • info: registra todos los niveles excepto los mensajes de depuración.
    • debug: registra todos los niveles de mensajes.

    Nota:

    SSMA registra mensajes obligatorios en cualquier nivel.

    Ejemplo:

    <output-providers>
  <log-verbosity level="fatal-error/error/warning/info/debug"/>
</output-providers>

    o

    <...All commands...>
  <log-verbosity level="fatal-error/error/warning/info/debug"/>
</...All commands...>

  10. Superar contraseña cifrada: Si true, la sección de definición de servidor del archivo de conexión del servidor o el archivo de script usa la contraseña en texto plano para superar la contraseña cifrada almacenada en almacenamiento seguro, si existe. Si no se especifica la contraseña de texto no cifrado, se le pedirá al usuario que escriba la contraseña.

    Surgen dos casos:

    1. Si la opción de invalidación es false, el orden de búsqueda es Almacenamiento protegido > Archivo de script > Archivo de conexión del servidor > Solicitar al usuario.

    2. Si la opción de invalidación es true, el orden de búsqueda es archivo de script > archivo de conexión > preguntar al usuario.

    Ejemplo:

    <output-providers>
  <encrypted-password override="<true/false>"/>
</output-providers>

La opción no configurable es:

  • Intentos máximos de reconexión: cuando una conexión establecida agota el tiempo de espera o se interrumpe debido a un error de red, el servidor debe volver a conectarse. La consola permite hasta cinco 5 reintentos para la reconexión. Después de estos reintentos, la consola realiza automáticamente la reconexión. La característica de reconexión automática reduce el esfuerzo en volver a ejecutar el script.

Parámetros de conexión del servidor

Puede definir parámetros de conexión de servidor en el archivo de script o en el archivo de conexión del servidor. Para obtener más información, consulte Creación de los archivos de conexión del servidor.

Comandos de script

El archivo de script contiene una secuencia de comandos de flujo de trabajo de migración en formato XML. La aplicación consola de SSMA procesa la migración en el orden de los comandos que aparecen en el archivo de script.

Por ejemplo, una migración de datos típica de una tabla específica de una base de datos de Access sigue la jerarquía de: Tabla de base de datos > .

Cuando todos los comandos del archivo de script se ejecutan correctamente, la aplicación de consola de SSMA sale y devuelve el control al usuario. El contenido de un archivo de script es más o menos estático, con información de variable contenida en archivos "Create variable value files" o en una sección independiente dentro del archivo de script para los valores de las variables.

Ejemplo:

<!--Sample of script file commands -->
<ssma-script-file>
  <script-commands>
    <create-new-project project-folder="$project_folder$"
                        project-name="$project_name$"
                        overwrite-if-exists="true"/>
    <connect-source-database server="source_2"/>
    <save-project/>
    <close-project/>
  </script-commands>
</ssma-script-file>

La carpeta Scripts de consola de ejemplo del directorio del producto proporciona plantillas que constan de tres archivos de script (para ejecutar varios escenarios), un archivo de valor variable y un archivo de conexión de servidor:

  • AssessmentReportGenerationSample.xml
  • ConversionAndDataMigrationSample.xml
  • VariableValueFileSample.xml
  • ServersConnectionFileSample.xml

Puede ejecutar las plantillas después de cambiar los parámetros de relevancia.

Para obtener una lista completa de comandos de script, consulte Ejecución de la consola SSMA.

Validación de archivos de script

Puede validar el archivo de script comparándolo con el archivo de definición de esquema en la carpeta A2SSConsoleScriptSchema.xsd.

Contenido relacionado

  • Last updated on