Conexiones de datos
Importante
To simplify the shift from Data Connections to DCM Connections, starting with the Server 2024.2 release it is possible to migrate all Data Connections and respective workflows to be replaced by DCM Connections.
First, it is necessary to migrate each data connection and then trigger the migration of workflows. Check our Maveryx Community blog post How to migrate Server Data Connections to DCM for more information.
Nota
Server-FIPS
Eliminamos las conexiones de datos heredadas de Server. En su lugar, puedes utilizar la funcionalidad del Administrador de conexiones de datos (DCM). El modo DCM forzado está activado y no se puede cambiar en la versión de Server compatible con FIPS. Entre las ventajas de DCM, se encuentran las credenciales de usuario almacenadas de forma segura para las conexiones de datos fuera del flujo de trabajo, el aumento de la seguridad, la mejora de la administración de las credenciales con contraseña y la sincronización de las credenciales entre Server y Designer. Consulta la página de ayuda DCM - Server para obtener más información.
En la página Conexiones de datos de la interfaz de administrador de Server , los administradores de Server pueden crear conexiones de datos en Server para permitir que los usuarios de Server se conecten a las bases de datos. Una vez configuradas, estas fuentes de datos están disponibles para que los usuarios que hayan agregado el Server las seleccionen de una lista y las utilicen.
Nota
Las conexiones de datos de Server son diferentes de las de Designer. Consulta Administrar conexiones de datos y Administrar conexiones en bases de datos para obtener más información sobre las conexiones de datos en Designer.
Las conexiones de datos de Server no están disponibles para las conexiones En-BD.
Agregar una conexión de datos
En la página Conexiones de datos , selecciona + Nuevo .
Selecciona el tipo de conexión en el menú desplegable Tecnología .
En Nombre , escribe un nombre para la conexión.
En Host , escribe el nombre de host de la base de datos SQL.
Selecciona una opción de autenticación.
Windows : utiliza las credenciales predeterminadas o introduce credenciales específicas para la conexión de datos.
SQL Server : introduce las credenciales del servidor. Las contraseñas no admiten plecas.
(Opcional) Selecciona Probar la conexión . Aparece un mensaje de verificación o error de conexión. Puedes guardar una conexión si la prueba falla.
(Opcional) Selecciona Base de datos para ver una lista de las bases de datos del servidor. Solo se muestra una lista si la prueba de conexión se ha realizado correctamente.
Selecciona una base de datos para establecerla como la base de datos predeterminada para esta conexión.
Selecciona escribir un nombre de base de datos e introduce el nombre de la base de datos en el servidor. Asegúrate de que el nombre contiene una barra diagonal (\) en el nombre del Server, como RM-LT-013\SQLEXPRESS2.
Selecciona Crear .
Todos los campos son obligatorios. Después de completar la información requerida, prueba la conexión.
En Nombre , escribe un nombre para la conexión.
En Host , ingresa el nombre de host o la dirección IP del servidor de Oracle.
En Nombre del servicio , ingresa el nombre de la aplicación basada en TNS en la red. Esta información es opcional si solo existe un servicio.
En Puerto , ingresa el puerto de escucha de red para la base de datos de Oracle. El valor predeterminado es 1521.
En Nombre de usuario y Contraseña , ingresa tu nombre de usuario y contraseña para la conexión de datos. Las contraseñas no admiten plecas.
(Opcional) Selecciona Probar la conexión . Aparece un mensaje de verificación o error de conexión. Puedes guardar una conexión si la prueba falla.
Selecciona Crear .
En Nombre , ingresa un nombre para la conexión.
Escribe una cadena de conexión en Cadena de conexión .
Las cadenas de conexión deben tener 212 caracteres o menos.
Se recomiendan las conexiones que no utilizan un nombre de fuente de datos (DSN). Esto también se conoce como conexión sin DSN.
Copiar cadenas de conexión de Designer
Puedes copiar y pegar cadenas de conexión de conexiones de datos creadas en Designer. Para ello, inicia sesión en Designer como administrador. Dirígete a Opciones > Opciones avanzadas > Administrar conexiones de datos .
Selecciona Crear .
Probar conexiones de datos
Pruebas de conexión en un Server de varios nodos
Una configuración de varios nodos de Server tiene un controlador y dos o más equipos trabajadores. En esta configuración, la funcionalidad de prueba evalúa la conexión en el equipo controlador, no en los equipos trabajadores individuales. Para asegurarte de que la conexión funcione en cualquiera de los equipos, confirma que los mismos controladores de base de datos y versiones de controlador están instalados en cada equipo.
Pruebas de conexión fallidas
Las pruebas de conexión pueden fallar por muchas razones. Estas son las razones más comunes por las que las pruebas de conexión fallan.
No tienes acceso al servidor o a la base de datos. Por ejemplo, en algunos casos, solo el usuario final de la conexión tiene autorización para acceder al servidor o a la base de datos.
La seguridad de la red también puede impedir que te conectes al servidor o a la base de datos.
El servidor no puede acceder al host del servidor de la base de datos. Para solucionar problemas, contacta al host del servidor de base de datos para asegurarte de que hay conectividad de red mientras estás conectado al servidor en el que está instalado Server.
Las credenciales de la base de datos no son válidas o no tienen los permisos de acceso adecuados. Comunícate con el administrador de la base de datos.
La base de datos no tiene conexión. Comunícate con el administrador de la base de datos para confirmar que la base de datos está en línea y funciona como se espera.
Estás ejecutando una configuración de varios nodos de Server.
Puedes guardar las conexiones de datos que no superen la prueba de conexión.
Credenciales predeterminadas utilizadas en las pruebas de conexiones
Puedes utilizar la autenticación de Windows o la autenticación de SQL Server para crear una conexión de Microsoft SQL Server. Para la autenticación de Windows, puedes utilizar credenciales predeterminadas o credenciales específicas para la conexión de datos. Puedes establecer credenciales predeterminadas en varias ubicaciones. Server busca las credenciales disponibles en estas ubicaciones y selecciona la credencial predeterminada en este orden:
Configuración del sistema > Worker > Run As . Dirígete a la página de ayuda de Trabajador para obtener más información sobre "Ejecutar como".
Windows Server Manager > Tools > Services . Busca AlteryxService , haz clic con el botón derecho y selecciona Propiedades . Las credenciales están en la pestaña Log On en This account .
Equipo local.
La prueba de conexión falla si las credenciales no son válidas.
Compartir una conexión de datos
Después de crear una conexión de datos, vuelve a la página Conexiones de datos para compartir la conexión con usuarios o grupos personalizados que la utilizarán en Designer.
Importante
Para permitir que el flujo de trabajo lo ejecuten usuarios o grupos específicos, comunícate con un administrador de Server para asegurarte de que las conexiones de datos necesarias se compartan con ellos.
En la página Conexiones de datos , selecciona la conexión de datos que deseas compartir.
En la pantalla Editar conexiones de datos , selecciona Usuarios o Grupos personalizados .
Selecciona + Agregar .
Introduce el nombre de un usuario o grupo.
Selecciona el usuario o grupo.
Selecciona Agregar .
El usuario, grupo o estudio con el que compartes la conexión aparece en la pestaña correspondiente. Consulta Herramienta Datos de entrada y Administrar conexiones de datos en la documentación de ayuda de Designer para ver cómo los usuarios acceden y administran las conexiones compartidas en Designer.
Importante
Para las conexiones de Microsoft SQL Server, confirma que el usuario tiene la misma versión o una versión más reciente de Microsoft SQL Server Native Client instalada en su equipo. Dirígete a Solución de problemas .
Revocar el acceso a una conexión de datos
Para revocar el acceso de un usuario a una conexión, selecciona Eliminar en el menú de tres puntos de este usuario. Para confirmar, selecciona Eliminar .
Editar una conexión de datos
En la página Conexiones de datos , selecciona la conexión de datos que desea editar.
En la pantalla Editar conexiones de datos , selecciona Editar .
Modifica la información en Nombre o Cadena de conexión .
Selecciona Guardar .
En las pestañas Usuarios o Grupos personalizados puedes compartir la conexión con usuarios y grupos .
Eliminar una conexión de datos
Para eliminar una conexión, selecciona Eliminar en el menú de tres puntos de esta conexión. A continuación, selecciona Eliminar .
Migrate Data Connections and Workflows to DCM
To shift from Data Connections to DCM Connections, migrate all Data Connections and respective workflows.
Migrate a Data Connection to DCM
As the first step in Data Connection migration, it is necessary to link the Data Connection to a DCM Connection, to be used as a replacement in workflows. Alteryx will assist you in finding the right DCM Connection and share the DCM Connection with the same set of users and user groups.
On the Data Connection detail page, select Migrate to DCM.
On the Migrate Connection to DCM screen, select the DCM Connection you want to associate the Data Connection with from the list of all DCM Connections present on Server.
Alteryx tries to find the best matching DCM Connection and loads it into the dropdown. It also groups all available DCM Connections into categories, depending on the type of match with the Server Data Connection. The groups are Perfect Match, Partial Match, Unresolved Vault, or Unmatched. For more information about these groups, go to Migration Tool.
Choose whether you want to Share to Existing Users. This shares the DCM Connection for collaboration with the same set of users and user groups as the migrated Data Connection. This option is enabled by default.
Nota
The DCM Connection gets shared for collaboration with all associated credentials. This is to reflect the Data Connection sharing behavior, allowing users to see and use the DCM Connection in Alteryx Designer. If you want to change which of the credentials are shared with others, initiate the Sharing for Collaboration first and then proceed with the migration.
You must be the DCM Connection owner to be able to share it with others. You may still proceed with the Data Connection migration, but it’s then on the owner to share the DCM Connection manually.
While workflows using Server Data Connections can be run by any Server user (with permission to the workflow), that’s not the case for DCM Connections. Sharing to Run on Server on the DCM Connection has to be initialized for all users, who would be running this workflow.
DCM Connections can’t be shared with Private Studios. These are currently ignored during this step.
Select Migrate.
Once this process is complete, the Data Connection is in a Migrated state. This means the Data Connection is still available to everyone, but can’t be shared or modified anymore, with all such actions now only available on the DCM Connection instead. No changes are made to the existing workflows at this point.
It is possible to Remigrate the Data Connection, which triggers the migration process described above. It allows you to choose a different DCM Connection to migrate to. Note: This doesn’t affect the sharing of the DCM Connection from the initial migration.
Migrate Workflows to DCM
After linking DCM Connections to your Data Connections, you can proceed with workflow migration. This process scans all workflows on the Server for Data Connections and replaces them with the linked DCM Connections. Workflows not containing any Data Connections are skipped.
On the Data Connections page, select Migrate Workflows to DCM.
To confirm the workflow migration, select Migrate in the Migrate Workflows dialogue.
All workflows stored on the Server are then checked for Data Connections to be automatically replaced by the associated DCM Connections.
Workflow is migrated only when all data connections used in that workflow are migrated to DCM.
A new version is created for each workflow migrated.
While it is possible to initiate the workflow migration repeatedly, only one migration can run on the Server at a time.
The status of the migration is visible on top of the Data Connections page. Refresh the page to update the current status.
Supported Technologies and Limitations
The following workflow file formats are supported:
YXMD (regular workflow)
YXWZ (analytic apps)
YXMC (macros)
Data connections uploaded as a data package (YXZP format) are not migrated because they don't include the metadata for the connections. As a result, they can't be migrated automatically.
Workflow is migrated only when all data connections used in that workflow are migrated to DCM.
All Server aliases in the Input Data and Output Data tools are gathered and replaced during workflow migration. Other tools are unsupported.
On a multi-node Server setup, the migration log will be present only on a node where the migration runs. Such is selected at random.
Resolución de problemas
No, puedes crear y compartir una conexión de datos sin probarla. También puedes guardar una conexión de datos si falla una prueba de conexión.
Las pruebas de conexión pueden fallar por muchas razones. Estas son las razones más comunes por las que las pruebas de conexión fallan.
No tienes acceso al servidor o a la base de datos. Por ejemplo, en algunos casos, solo el usuario final de la conexión tiene autorización para acceder al servidor o a la base de datos.
La seguridad de la red también puede impedir que te conectes al servidor o a la base de datos.
El servidor no puede acceder al host del servidor de la base de datos. Para solucionar problemas, contacta al host del servidor de base de datos para asegurarte de que hay conectividad de red mientras estás conectado al servidor en el que está instalado Server.
Las credenciales de la base de datos no son válidas o no tienen los permisos de acceso adecuados. Comunícate con el administrador de la base de datos.
La base de datos no tiene conexión. Comunícate con el administrador de la base de datos para confirmar que la base de datos está en línea y funciona como se espera.
Estás ejecutando una configuración de varios nodos de Alteryx Server. Dirígete a la sección Probar conexiones de datos de este artículo para obtener información sobre las pruebas de conexiones en un Server de varios nodos.
Puedes guardar las conexiones de datos que no superen la prueba de conexión.
Puedes utilizar la autenticación de Windows o la autenticación de SQL Server para crear una conexión de Microsoft SQL Server. Para la autenticación de Windows, puedes utilizar credenciales predeterminadas o credenciales específicas para la conexión de datos. Puedes establecer credenciales predeterminadas en varias ubicaciones. Server busca las credenciales disponibles en estas ubicaciones y selecciona la credencial predeterminada en este orden:
Configuración del sistema > Worker > Run As . Dirígete a la página de ayuda de Trabajador para obtener más información sobre "Ejecutar como".
Windows Server Manager > Tools > Services . Busca AlteryxService , haz clic con el botón derecho y selecciona Propiedades . Las credenciales están en la pestaña Log On en This account .
Equipo local.
La prueba de conexión falla si las credenciales no son válidas.
Hay muchas razones por las que un usuario no puede ver una conexión de datos de Server en Designer. Sigue estos pasos para solucionar el problema.
Confirma que has compartido la conexión de datos con el usuario. Edita la conexión de datos y busca el usuario en la lista Usuarios y estudios.
Confirma que la dirección de correo electrónico que utiliza el usuario para iniciar sesión en la interfaz de usuario de Server es la misma dirección con la que compartiste la conexión.
Solicítale al usuario que elimine el Server de Designer y lo vuelva a agregar utilizando las credenciales correctas.
Si estás compartiendo la conexión con un estudio, confirma que el usuario tiene acceso a ese estudio.
Un usuario puede recibir este error en Designer o en Server al intentar utilizar una conexión de datos creada en un equipo que utiliza una versión de un controlador de Microsoft SQL Server distinta a la del equipo en el que se utiliza la conexión de datos.
El equipo debe tener la misma versión o una versión más reciente de un controlador de Microsoft SQL Server. Por ejemplo, el mensaje de error aparece cuando el equipo en el que se usa la conexión de datos utiliza la versión 10.0 de un controlador de Microsoft SQL Server y el equipo en el que se creó la conexión de datos utiliza la versión 11.0.
Es posible que el usuario que creó el flujo de trabajo en Designer y lo guardó en Server no tenga permiso para utilizar la conexión de datos compartida. Para solucionar el problema, sigue estos pasos.
Abre el log AlteryxService (AlteryxServiceLog.log). El log de servicio se guarda en una ubicación establecida durante la configuración. Dirígete a Configurar y utilizar los logs para obtener más información.
Busca la marca de hora en la que se produjo el error y revisa la descripción del error.
Si la descripción indica “No se puede encontrar el permiso para la conexión de datos: [Nombre de la conexión de datos]”, el usuario no tiene acceso a la conexión de datos.
Edita la conexión de datos y compártela con el usuario.