Compartir vía

Parametrizar servicios vinculados en Azure Data Factory y Azure Synapse Analytics

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Sugerencia

Data Factory en Microsoft Fabric es la próxima generación de Azure Data Factory, con una arquitectura más sencilla, inteligencia artificial integrada y nuevas características. Si no está familiarizado con la integración de datos, comience con Fabric Data Factory. Las cargas de trabajo de ADF existentes pueden actualizarse a Fabric para acceder a nuevas funcionalidades en ciencia de datos, análisis en tiempo real e informes.

Ahora puede parametrizar un servicio vinculado y pasar valores dinámicos en tiempo de ejecución. Por ejemplo, si quiere conectarse a bases de datos diferentes en el mismo servidor lógico de SQL, ahora puede parametrizar el nombre de la base de datos en la definición del servicio vinculado. Esto evita tener que crear un servicio vinculado para cada base de datos del servidor lógico de SQL. Por ejemplo, puede parametrizar otras propiedades en la definición de servicio vinculado también; por ejemplo, Nombre de usuario.

Puede usar la interfaz de usuario en el portal de Azure o una interfaz de programación para parametrizar los servicios vinculados.

Sugerencia

Se recomienda no parametrizar las contraseñas ni los secretos. Almacene todos los secretos en Azure Key Vault en su lugar y parametrice la Secret Name.

Nota:

  1. Hay un error abierto para usar "-" en los nombres de parámetro; se recomienda usar nombres sin "-" hasta que se resuelva el error.
  2. Hay un error activo que afecta a los flujos de datos con parámetros. Para evitar problemas, se recomienda usar nombres de flujo de datos sin espacios hasta que se resuelva el error.

Si desea una demostración y una introducción de siete minutos de esta característica, vea el siguiente vídeo:

Tipos de servicios vinculados admitidos

Todos los tipos de servicio vinculados se admiten para la parametrización.

Admitidos de forma nativa en la interfaz de usuario: al crear un servicio vinculado en la interfaz de usuario, el servicio proporciona una experiencia de parametrización integrada para los siguientes tipos de servicios vinculados. En la hoja de creación y edición del servicio vinculado, puede buscar las opciones de los nuevos parámetros y agregar contenido dinámico. Vea Experiencia de UI.

  • Amazon Redshift
  • Amazon S3
  • Almacenamiento compatible con Amazon S3
  • Azure Blob Storage
  • Azure Cosmos DB para NoSQL
  • Azure Databricks Delta Lake
  • Azure Data Explorer
  • Azure Data Lake Storage Gen1
  • Azure Data Lake Storage Gen2
  • Base de Datos Azure para MySQL
  • Azure Database for PostgreSQL
  • Azure Databricks
  • almacenamiento de archivos de Azure
  • función Azure
  • Azure Key Vault
  • Azure SQL Database
  • Azure SQL Managed Instance
  • Azure Synapse Analytics
  • Azure Table Storage
  • Dataverse
  • DB2
  • Dynamics 365
  • Dynamics AX
  • DYNAMICS CRM
  • Sistema de archivos
  • FTP
  • HTTP genérico
  • REST genérico
  • Google AdWords
  • Google BigQuery
  • Informix
  • MariaDB
  • Microsoft Access
  • MySQL
  • OData
  • ODBC
  • Oracle
  • Oracle Cloud Storage
  • PostgreSQL
  • Salesforce
  • Servicio de Salesforce en la nube
  • SAP CDC
  • SAP HANA
  • Tabla de SAP
  • ServiceNow (no se admite en la versión heredada de ServiceNow)
  • SFTP
  • Lista Online de SharePoint
  • Snowflake
  • SQL Server
  • Vertica

Creación avanzada: para otros tipos de servicios vinculados que no están en la lista anterior, puede parametrizar el servicio vinculado mediante la edición del código JSON en la interfaz de usuario:

  • En la hoja de creación y edición del servicio vinculado -> expanda "Advanced" (Avanzado) -> active la casilla "Specify dynamic contents in JSON format"> (Especificar contenido dinámico en formato JSON) -> especifique la carga JSON del servicio vinculado.
  • O bien, después de crear un servicio vinculado sin parametrización, en Centro de administración -> Servicios vinculados -> busque el servicio vinculado específico -> seleccione el "Código" (botón "{}") para editar el JSON.

Consulte el ejemplo de JSON para agregar la sección parameters para definir los parámetros y hacer referencia al parámetro mediante @{linkedService().paramName}.

Experiencia de UI

JSON

{
	"name": "AzureSqlDatabase",
	"properties": {
		"type": "AzureSqlDatabase",
		"typeProperties": {
			"connectionString": "Server=tcp:myserver.database.windows.net,1433;Database=@{linkedService().DBName};User ID=user;Password=fake;Trusted_Connection=False;Encrypt=True;Connection Timeout=30"
		},
		"connectVia": null,
		"parameters": {
			"DBName": {
				"type": "String"
			}
		}
	}
}

Contenido relacionado

Almacenar credenciales en Azure Key Vault\

  • Last updated on