Share via

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

  • Artigo

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Dica

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange desde movimentação de dados até ciência de dados, análise em tempo real, business intelligence e relatórios. Saiba como iniciar uma avaliação gratuita!

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.

É possível usar a interface do usuário no portal do Azure ou uma interface de programação para parametrizar os serviços vinculados.

Dica

É recomendável não parametrizar senhas ou segredos. Armazene todos os segredos no Azure Key Vault e defina o Nome secreto.

Observação

Há um bug aberto para usar "-" em nomes de parâmetro, é recomendável usar nomes sem "-" 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: ao criar o serviço vinculado na interface do usuário, o serviço oferece 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 do Blobs do Azure
  • Azure Cosmos DB para NoSQL
  • Delta Lake do Azure Databricks
  • Azure Data Explorer
  • Azure Data Lake Storage Gen1
  • Azure Data Lake Storage Gen2
  • Banco de Dados do Azure para MySQL
  • Banco de Dados do Azure para PostgreSQL
  • Azure Databricks
  • Armazenamento de Arquivos do Azure
  • Azure Function
  • Cofre de Chave do Azure
  • Banco de Dados SQL do Azure
  • Instância Gerenciada do Azure SQL
  • 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
  • ODBCODBC
  • Oracle
  • Oracle Cloud Storage
  • PostgreSQL
  • Salesforce
  • Salesforce Service Cloud
  • DCD do SAP
  • SAP HANA
  • Tabela SAP
  • SFTP
  • Lista do SharePoint Online
  • Snowflake
  • SQL Server

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 editando o 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 –> clique em "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"
			}
		}
	}
}