Parametrizar serviços vinculados no Azure Data Factory e no Azure Synapse Analytics
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
- ServiceNow (sem suportado no ServiceNow herdado)
- SFTP
- Lista do 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 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"
}
}
}
}