Parametrisera länkade tjänster i Azure Data Factory och Azure Synapse Analytics

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Tips

Data Factory i Microsoft Fabric är nästa generations Azure Data Factory, med en enklare arkitektur, inbyggd AI och nya funktioner. Om dataintegrering är nytt för dig börjar du med Fabric Data Factory. Befintliga ADF-arbetsbelastningar kan uppgraderas till Fabric för att få åtkomst till nya funktioner inom datavetenskap, realtidsanalys och rapportering.

Nu kan du parametrisera en länkad tjänst och skicka dynamiska värden vid körning. Om du till exempel vill ansluta till olika databaser på samma logiska SQL-server kan du nu parametrisera databasnamnet i den länkade tjänstdefinitionen. Detta förhindrar att du behöver skapa en länkad tjänst för varje databas på den logiska SQL-servern. Du kan även parametrisera andra egenskaper i den länkade tjänstdefinitionen – till exempel Användarnamn.

Du kan använda användargränssnittet i Azure-portalen eller ett programmeringsgränssnitt för att parametrisera länkade tjänster.

Tips

Vi rekommenderar att du inte parameteriserar lösenord eller hemligheter. Lagra alla hemligheter i Azure Key Vault i stället och parametrisera Secret Name.

Kommentar

  1. Det finns en öppen bugg för att använda "-" i parameternamn. Vi rekommenderar att du använder namn utan "-" tills felet har lösts.
  2. Det finns en aktiv bugg som påverkar dataflöden med parametrar. För att undvika problem rekommenderar vi att du använder dataflödesnamn utan blanksteg tills felet har lösts.

För en sju minuter lång introduktion och demonstration av den här funktionen kan du titta på följande video:

Länkade tjänsttyper som stöds

Alla länkade tjänsttyper stöds för parameterisering.

Internt stöd i användargränssnittet: När du redigerar länkad tjänst i användargränssnittet ger tjänsten inbyggd parameteriseringsupplevelse för följande typer av länkade tjänster. På bladet skapa/redigera länkad tjänst kan du hitta alternativ för nya parametrar och lägga till dynamiskt innehåll. Se användargränssnittets upplevelse.

  • Amazon Redshift
  • Amazon S3
  • Amazon S3-kompatibel lagring
  • Azure Blob Storage
  • Azure Cosmos DB för NoSQL
  • Azure Databricks Delta Lake
  • Azure Data Explorer
  • Azure Data Lake Storage Gen1
  • Azure Data Lake Storage Gen2
  • Azure Database for MySQL
  • Azure Database for PostgreSQL
  • Azure Databricks
  • Azure File Storage
  • Azure funktion
  • Azure Key Vault
  • Azure SQL Database
  • Azure SQL Managed Instance
  • Azure Synapse Analytics
  • Azure Table Storage-lagringslösning
  • Dataverse
  • DB2
  • Dynamics 365
  • Dynamics AX
  • Dynamics CRM
  • Filsystem
  • FTP
  • Generisk HTTP
  • REST (allmän)
  • Google AdWords
  • Google BigQuery (ett molnbaserat dataanalysverktyg)
  • Informix
  • MariaDB
  • Microsoft Access
  • MySQL
  • OData
  • ODBC
  • Oracle
  • Oracle Cloud Storage
  • PostgreSQL
  • Salesforce
  • Salesforce Service Cloud
  • SAP CDC
  • SAP HANA
  • SAP-tabell
  • ServiceNow (stöds inte i ServiceNows äldre version)
  • SFTP
  • SharePoint onlinelista
  • Snöflinga
  • SQL Server
  • Vertica

Avancerad redigering: För andra länkade tjänsttyper som inte finns i listan ovan kan du parametrisera den länkade tjänsten genom att redigera JSON i användargränssnittet:

  • I bladet skapa/redigera länkad tjänst –> expandera "Avancerat" längst ned –> markera kryssrutan "Ange dynamiskt innehåll i JSON-format" –> ange den länkade JSON-nyttolasten för tjänsten.
  • Eller när du har skapat en länkad tjänst utan parameterisering i Hanteringshubben –> Länkade tjänster –> hitta den specifika länkade tjänsten –> väljer du "Kod" (knapp "{}") för att redigera JSON.

Se JSON-exemplet för att lägga parameters till avsnittet för att definiera parametrar och referera till parametern med hjälp av @{linkedService().paramName}.

Användargränssnittsupplevelse

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

Arkivautentiseringsuppgifter i Azure Key Vault