Partilhar via


Parametrizar serviços ligados no Azure Data Factory e Azure Synapse Analytics

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Gorjeta

Data Factory em Microsoft Fabric é a próxima geração de Azure Data Factory, com uma arquitetura mais simples, IA incorporada e novas funcionalidades. Se és novo na integração de dados, começa pelo Fabric Data Factory. As cargas de trabalho existentes do ADF podem atualizar para o Fabric para aceder a novas capacidades em ciência de dados, análise em tempo real e relatórios.

Agora você pode parametrizar um serviço vinculado e passar valores dinâmicos em tempo de execução. Por exemplo, se você quiser se conectar a bancos de dados diferentes no mesmo servidor SQL lógico, agora você pode parametrizar o nome do banco de dados na definição de serviço vinculado. Isso evita que você tenha que criar um serviço vinculado para cada banco de dados no servidor SQL lógico. Você também pode parametrizar outras propriedades na definição de serviço vinculado - por exemplo, Nome de usuário.

Podes usar a interface no portal do Azure ou uma interface de programação para parametrizar serviços ligados.

Gorjeta

Recomendamos não parametrizar senhas ou segredos. Armazene todos os segredos em Azure Key Vault e parametrize o Nome Secreto.

Nota

  1. Há bug aberto para usar "-" em nomes de parâmetros, recomendamos usar nomes sem "-" até que o bug seja resolvido.
  2. Há um bug ativo que afeta os fluxos de dados com parâmetros. Para evitar problemas, recomenda-se usar nomes de fluxo de dados sem espaços até que o bug seja resolvido.

Para uma introdução de sete minutos e demonstração desse recurso, assista ao seguinte vídeo:

Tipos de serviço vinculado suportados

Todos os tipos de serviço vinculados são suportados para parametrização.

Suporte nativo na interface do usuário: ao criar o serviço vinculado na interface do usuário, o serviço fornece experiência de parametrização interna para os seguintes tipos de serviços vinculados. Na folha de criação/edição do serviço vinculado, você pode encontrar opções para novos parâmetros e adicionar conteúdo dinâmico. Consulte a experiência de interface de utilizador.

  • Amazon Redshift
  • Amazon S3
  • Armazenamento Compatível com o Amazon S3
  • Armazenamento de Blobs do Azure (Armazenamento de Blobs do Azure)
  • Azure Cosmos DB para NoSQL
  • Azure Databricks Delta Lake
  • Azure Data Explorer
  • Azure Data Lake Storage Gen1
  • Azure Data Lake Storage Gen2
  • Azure Database para MySQL
  • Azure Database para PostgreSQL
  • Azure Databricks
  • Azure File Storage
  • Azure Function
  • Azure Key Vault
  • Base de Dados SQL do Azure
  • Azure SQL Managed Instance
  • Azure Synapse Analytics
  • Armazenamento de Tabelas do Azure
  • Dataverse
  • DB2
  • Dynamics 365
  • Dynamics AX
  • Dynamics CRM
  • Sistema de Ficheiros
  • FTP
  • HTTP genérico
  • REST genérico
  • AdWords do Google
  • Google BigQuery (plataforma de análise de dados)
  • Informix
  • MariaDB
  • Microsoft Access
  • MySQL
  • OData
  • ODBC
  • Oracle
  • Armazenamento em nuvem Oracle
  • PostgreSQL
  • Salesforce
  • Salesforce Service Cloud
  • SAP CDC
  • SAP HANA
  • Tabela SAP
  • ServiceNow (não suportado na versão antiga do ServiceNow)
  • SFTP
  • Lista Online do SharePoint
  • Snowflake
  • SQL Server
  • Vertica

Criação avançada: para outros tipos de serviço vinculado que não estão na lista acima, você pode parametrizar o serviço vinculado editando o JSON na interface do usuário:

  • Na folha de criação/edição do serviço associado -> expanda "Avançado" na parte inferior -> selecione a opção "Especificar conteúdo dinâmico no formato JSON" -> especifique a carga JSON do serviço associado.
  • Ou, depois de criar um serviço ligado sem parametrização, no centro de gestão -> Serviços ligados -> encontre o serviço ligado específico -> selecione o "Código" (botão "{}") para editar o JSON.

Consulte o exemplo de JSON para adicionar a secção parameters e definir parâmetros, referenciando o parâmetro usando @{linkedService().paramName}.

Experiência da interface do usuário

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"
			}
		}
	}
}

Armazena credenciais em Azure Key Vault