Este artículo proporciona una descripción general de nuestro soporte para Alteryx Server con SQL administrado por el usuario como capa de persistencia e información sobre cómo migrar de MongoDB a SQL.
Oficialmente admitimos MSSQL Server 2019 y 2022, así como Amazon RDS para SQL Server.
Sí. Se admite Amazon RDS para SQL Server.
El usuario de acceso a la base de datos SQL debe tener inicialmente privilegios de administrador para crear y usar cualquier base de datos que Alteryx Server requiera. Una vez que se complete la configuración de SQL y se realice cualquier migración de MongoDB a SQL (si corresponde), estos privilegios se pueden reducir. Sin embargo, el usuario seguirá necesitando permisos para leer, escribir, eliminar registros y crear o eliminar tablas, pero ya no requerirá derechos completos de creación de bases de datos.
No, en este momento solo ofrecemos MSSQL como opción de base de datos para bases de datos administradas por el usuario.
Sí.
Sí.
Sí.
Sí. Hubo ligeros cambios en el esquema con la nueva base de datos SQL. Si estabas consultando directamente a Mongo, debes verificar tus consultas y quizá actualizarlas. Para obtener más información, visita la página de ayuda Referencia de esquemas de base de datos SQL.
No, estas bases de datos pueden estar ubicadas en el mismo lugar.
Sí.
Sí.
Sí, puedes ejecutar una instancia de servidor SQL junto con otras instancias de base de datos.
El rendimiento debería ser igual entre SQL y Mongo en la mayoría de los casos. El único rendimiento significativamente más lento se produce en los flujos de trabajo que tardan 5 segundos o menos en ejecutarse. Consulta la siguiente tabla para comparar los tiempos. Para los flujos de trabajo que tardan más de 5 segundos en ejecutarse, las diferencias de rendimiento son insignificantes.
En el ejemplo más extremo, si un usuario ejecutara 60 flujos de trabajo por minuto que tardaran 1 segundo cada uno, la diferencia en el tiempo de finalización pasaría de 1 minuto en Mongo a 1 minuto y 15 segundos en SQL.
En última instancia, la diferencia de rendimiento depende de los flujos de trabajo que se estén ejecutando, pero dado que la desaceleración solo ocurre con flujos de trabajo que se ejecutan rápidamente, la diferencia de 0,25 segundos no debería generar una diferencia significativa en el rendimiento.
Tiempo de ejecución del flujo de trabajo de Mongo | Tiempo de ejecución del flujo de trabajo SQL |
|---|---|
5 segundos | 5,25 segundos |
1 segundo | 1,25 segundos |
Para consultar las instrucciones completas de migración de MongoDB a SQL, consulta la Guía de migración de MongoDB a SQL. Revisa las instrucciones de migración completas, ya que estas preguntas frecuentes solo responden a las preguntas principales.
Server 2022.1+. Si tienes una versión anterior a 2022.1, te recomendamos actualizar a una versión 2022.1 - 2023.2 antes de actualizar a 2024.1.
Sí.
No, la migración de SQL se realiza mediante un flujo de trabajo que puedes ejecutar después de actualizar a 2024.1. Esto te permite actualizar a 2024.1 y realizar tus pruebas iniciales antes de migrar a SQL.
No. Esta es una migración opcional y si no deseas migrar a SQL en 2024.1, puedes hacerlo en una versión futura.
Recomendamos que el tamaño de tu base de datos SQL sea el doble del tamaño de tu MongoDB existente. Esto se debe a que Mongo comprime el tamaño de la base de datos y no ocurre la misma compresión en MSSQL.
Para realizar pruebas, puedes ejecutar el migrador cuando el servicio se esté ejecutando. Después de la prueba, elimina todos los registros (no las tablas) de la base de datos SQL antes de ejecutar la migración final. Cierra completamente el servicio para la migración final y así todos los registros se trasladarán ahora.
Sí. Si el migrador se interrumpe o se detiene antes de completarse, comenzará donde terminó y continuará transfiriendo registros. Esto solo aplica si el servicio permanece inactivo y no hay cambios en la base de datos durante el período de detención.
Si detienes la migración, se inicia el servicio y se realizan cambios en MongoDB, deberás borrar el contenido de la tabla SQL, no las tablas en sí, antes de volver a ejecutar el migrador.
Verás 0 errores en la ventana de resultados y los registros mostrarán todos los registros transferidos de MongoDB a MSSQL.
bcp_batch
Ejemplo de mensaje de error:
MongoToSQL_Migration_Macro (829): Migrador (22): Registro n.º 17: BatchTransferProcess (574): Registro n.º 1: Herramienta n.º 9: No se puede encontrar la dirección para bcp_batch¿Cuándo ocurre el error? Durante la migración, el error se mostrará en la ventana Resultados.
Solución: Asegúrate de que el controlador SQL correcto (controlador SQL ODBC 17) esté instalado y configurado.
El servicio no se pudo iniciar después de la migración
Ejemplo de mensaje de error (en registros de servicio):
ERROR,1,AlteryxServerMigrator,migrationLogger,ExecuteServerSqlDbMigrations, Las migraciones de la base de datos SQL de Server han fallado: el destino de una invocación ha lanzado una excepción.¿Cuándo ocurre el error?
Después de la migración, el error se mostrará en \Alteryx\Service\alteryx-migration.csv.
Se genera este error si especificas incorrectamente un controlador como parte de la cadena de conexión de la interfaz de usuario de Server.
Solución:
AlteryxService debe iniciarse al menos una vez con MongoDB como back-end ANTES de migrar datos a MSSQL. Esto garantiza que el esquema de MongoDB se actualice correctamente.
Revisa tus cadenas de conexión. En particular, asegúrate de no especificar un controlador en la cadena de conexión de persistencia de la interfaz de usuario de Server. Para obtener más información, ve a Cadenas de conexión avanzadas de base de datos de SQL.
Error de conversión de cadena a número
Ejemplo de mensaje de error:
Error: MongoToSQL_Migration_Macro (829): Migrador (22): Registro n.º 54: BatchTransferProcess (574): Registro n.º 1: Herramienta n.º 2: Error SQLFetch: [Simba][Soporte] (50090) Conversión de cadena a número falló con el valor ''[Simba][Soporte] (50090) La conversión de cadena a número falló con el valor ''[Simba][Soporte] (50090) La conversión de cadena a número falló con el valor ''¿Cuándo ocurre el error?: Durante la migración, el error se mostrará en la ventana Resultados.
Solución: AlteryxService debe iniciarse al menos una vez con MongoDB como back-end ANTES de migrar datos a MSSQL. Esto garantiza que el esquema de MongoDB se actualice correctamente.
AlteryxGallery.alteryx_server.Table_Name
Mensaje de error de ejemplo:
Error: MongoToSQL_Migration_Macro (829): Herramienta n.º 46: Error al abrir “SELECCIONAR COUNT(DISTINCT Primary_Key) COMO Count_distinct DE AlteryxGallery.alteryx_server.Table_Name”: no se devolvió ninguna columna.¿Cuándo ocurre el error? Durante la migración, el error se mostrará en la ventana Resultados.
Solución:
Asegúrate de que el esquema de MongoDB esté PUBLICADO en MongoDB mientras configuras el controlador Simba.
Asegúrate de definir la fuente de autenticación apropiada cuando crees las credenciales de DCM para cada conexión. Para acceder al cuadro de texto Fuente de autenticación, expande la sección Parámetros avanzados debajo de las entradas de nombre de usuario y contraseña cuando crees tus credenciales.
Si utilizas MongoDB incrustado, necesitarás dos credenciales diferentes: una para la base de datos de AlteryxService y otra para la base de datos AlteryxGallery para la fuente de autenticación. Para obtener más información, consulta Guía de migración de Mongo a SQL.
Comando no autorizado durante la configuración del esquema MongoDB
Ejemplo de mensaje de error:
[Simba][MongoDBODBC] (110) Error del cliente MongoDB: no autorizado en la prueba para ejecutar el comando {insert: "DatabaseMetadata_SchemaMap", ordered: true, $db: "test", lsid: { id: UUID("9819f76d-486b-4722-a4f1-f8398cd9a4ae") } } (Código de error: 13)¿Cuándo ocurre el error? Al intentar publicar el esquema de MongoDB durante la configuración del controlador Simba.
Solución: Asegúrate de que la base de datos de autenticación esté configurada en la base de datos de destino. Por lo tanto, al crear la entrada DSN para AlteryxGallery, configura la base de datos de autenticación en AlteryxGallery, no en admin.
El flujo de trabajo produce errores durante una falla. Si esto ocurre, informa el error desde la ventana Resultados y envía las capturas de pantalla y los archivos de registro creados durante la ejecución a tu equipo de soporte.
Si la migración falla, puedes iniciar AlteryxService nuevamente y continuar usando tu MongoDB. En este punto, Mongo todavía está completamente conectado y funcional, por lo que no necesitas hacer nada más para continuar usando Mongo si la migración falla.
Si hiciste una copia de seguridad de tu archivo RuntimeSettings.xml antes de la migración, puedes cambiarlo por tu archivo RuntimeSettings.xml actual (hacer copias de seguridad de estos dos archivos puede ser útil). Sin embargo, cualquier cambio realizado en Server mientras estás conectado a SQL no se representará después de volver a MongoDB.
No. Los datos no se modifican. Sin embargo, se crea 1 colección para almacenar el esquema de ODBC de Simba MongoDB.
Actualmente, la migración de MongoDB a SQL no es compatible con los entornos FIPS. Sin embargo, los NUEVOS entornos FIPS se pueden configurar utilizando MSSQL administrado por el usuario.