Compartilhar via

Parametrizar serviços vinculados em Azure Data Factory e Azure Synapse Analytics

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Dica

Data Factory no Microsoft Fabric é a próxima geração de Azure Data Factory, com uma arquitetura mais simples, IA interna e novos recursos. Se você não estiver familiarizado com a integração de dados, comece com Fabric Data Factory. As cargas de trabalho existentes do ADF podem ser atualizadas para Fabric para acessar novos recursos em ciência de dados, análise em tempo real e relatórios.

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

Você pode usar a interface do usuário no portal Azure ou uma interface de programação para parametrizar serviços vinculados.

Dica

É recomendável não parametrizar senhas ou segredos. Armazene todos os segredos em Azure Key Vault e parametrize o Secret Name.

Observação

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

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

Tipos de serviço vinculado com suporte

Todos os tipos de serviço vinculados têm suporte para parametrização.

Com suporte nativo na interface do usuário: quando cria o serviço vinculado na interface do usuário, o serviço oferece uma experiência de parametrização integrada para os seguintes tipos de serviços vinculados. Na folha criação/edição do serviço vinculado, você pode encontrar opções para novos parâmetros e adicionar conteúdo dinâmico. Consulte experiência de interface do usuário.

  • Amazon Redshift
  • Amazon S3
  • Armazenamento compatível com Amazon S3
  • Armazenamento de Blobs do Azure (armazenamento de objetos 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
  • Banco de Dados do Azure para PostgreSQL
  • Azure Databricks
  • armazenamento de arquivos Azure
  • Função Azure
  • Azure Key Vault
  • Banco de Dados SQL do Azure
  • Instância Gerenciada de SQL do Azure
  • Azure Synapse Analytics
  • Armazenamento de Tabelas do Azure
  • Dataverse
  • DB2
  • Dynamics 365
  • Dynamics AX
  • DYNAMICS CRM
  • Sistema de Arquivos
  • FTP
  • HTTP Genérico
  • REST Genérico
  • Google AdWords
  • BigQuery do Google
  • Informix
  • MariaDB
  • Microsoft Access
  • MySQL
  • OData
  • ODBC
  • Oracle
  • Armazenamento em Nuvem Oracle
  • PostgreSQL
  • Salesforce
  • Serviço Cloud da Salesforce
  • DCD do SAP
  • SAP HANA
  • Tabela SAP
  • ServiceNow (sem suporte no ServiceNow herdado)
  • SFTP
  • Lista SharePoint Online
  • Snowflake
  • SQL Server
  • Vertica

Criação avançada: para outros tipos de serviços vinculados não incluídos na lista acima, você pode parametrizar o serviço vinculado por meio da edição do JSON na interface do usuário:

  • Na folha de criação/edição do serviço vinculado –> expanda "Avançado" na parte inferior –> marque a caixa de seleção "Especificar conteúdo dinâmico no formato JSON –> especifique o payload do JSON do serviço vinculado.
  • Ou, depois de criar um serviço vinculado sem parametrização, no Hub de Gerenciamento –> Serviços vinculados –> localize o serviço vinculado específico –> selecione "Código" (botão "{}") para editar o JSON.

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

Experiência de 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"
			}
		}
	}
}

Conteúdo relacionado

Armazenar credenciais no Azure Key Vault

  • Last updated on