Freigeben über

Parametrisieren verknüpfter Dienste in Azure Data Factory und Azure Synapse Analytics

  • Artikel

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Tipp

Testen Sie Data Factory in Microsoft Fabric, eine All-in-One-Analyselösung für Unternehmen. Microsoft Fabric deckt alle Aufgaben ab, von der Datenverschiebung bis hin zu Data Science, Echtzeitanalysen, Business Intelligence und Berichterstellung. Erfahren Sie, wie Sie kostenlos eine neue Testversion starten!

Sie können jetzt einen verknüpften Dienst parametrisieren und dynamische Werte zur Laufzeit übergeben. Wenn Sie beispielsweise Verbindungen mit verschiedenen Datenbanken auf demselben logischen SQL-Server herstellen möchten, können Sie nun den Datenbanknamen in der verknüpften Dienstdefinition parametrisieren. Dadurch wird vermieden, dass Sie für jede Datenbank auf dem logischen SQL-Server einen verknüpften Dienst erstellen müssen. Sie können auch andere Eigenschaften in der Definition des verknüpften Diensts parametrisieren, z.B. den Benutzernamen.

Sie können verknüpfte Dienste mithilfe der Benutzeroberfläche im Azure-Portal oder über eine Programmierschnittstelle parametrisieren.

Tipp

Es wird empfohlen, Kennwörter oder Geheimnisse nicht zu parametrisieren. Speichern Sie stattdessen alle Geheimnisse in Azure Key Vault, und parametrisieren Sie den geheimen Namen.

Hinweis

Es gibt derzeit noch einen ungelösten Fehler bei Verwendung von „-“ in Parameternamen. Es wird empfohlen, Namen ohne „-“ zu verwenden, bis der Fehler behoben wurde.

Das folgende Video enthält eine siebenminütige Einführung und Demonstration dieses Features:

Unterstützte Arten verknüpfter Dienste

Alle verknüpften Diensttypen werden für die Parametrisierung unterstützt.

Nativ in der Benutzeroberfläche unterstützt: Für die Erstellung verknüpfter Dienste in der Benutzeroberfläche bietet der Dienst eine integrierte Parametrisierungsfunktion für die folgenden Arten verknüpfter Dienste. Im Blatt zur Erstellung/Bearbeitung von verknüpften Diensten finden Sie Optionen für neue Parameter und können dynamische Inhalte hinzufügen. Siehe Benutzeroberfläche.

  • Amazon Redshift
  • Amazon S3
  • Amazon S3 Compatible Storage
  • Azure Blob Storage
  • Azure Cosmos DB for NoSQL
  • Azure Databricks Delta Lake
  • Azure-Daten-Explorer
  • Azure Data Lake Storage Gen1
  • Azure Data Lake Storage Gen2
  • Azure Database for MySQL
  • Azure-Datenbank für PostgreSQL
  • Azure Databricks
  • Azure File Storage
  • Azure Function
  • Azure-Schlüsseltresor
  • Azure SQL-Datenbank
  • Verwaltete Azure SQL-Instanz
  • Azure Synapse Analytics
  • Azure Table Storage
  • Dataverse
  • DB2
  • Dynamics 365
  • Dynamics AX
  • Dynamics CRM
  • Dateisystem
  • FTP
  • Generisches HTTP
  • Generisches REST
  • Google AdWords
  • Google BigQuery
  • Informix
  • MariaDB
  • Microsoft Access
  • MySQL
  • OData
  • ODBC
  • Oracle
  • Oracle Cloud Storage
  • PostgreSQL
  • Salesforce
  • Salesforce Service Cloud
  • SAP CDC
  • SAP HANA
  • SAP-Tabelle
  • ServiceNow (in der Legacyversion von ServiceNow nicht unterstützt)
  • SFTP
  • SharePoint Online-Liste
  • Snowflake
  • SQL Server

Erweiterte Erstellung: Für andere Arten verknüpfter Dienste, die nicht in der obigen Liste enthalten sind, können Sie den verknüpften Dienst parametrisieren, indem Sie die JSON über die Benutzeroberfläche bearbeiten:

  • Erweitern Sie auf dem Blatt zur Erstellung/Bearbeitung von verknüpften Diensten die Option „Erweitert“ am unteren Rand. Aktivieren Sie dann das Kontrollkästchen „Dynamische Inhalte im JSON-Format angeben“, und geben Sie die JSON-Nutzlast für den verknüpften Dienst an.
  • Alternativ können Sie nach dem Erstellen eines verknüpften Diensts ohne Parametrisierung unter „Verwaltungshub“ > „Verknüpfte Dienste“ den bestimmten verknüpften Dienst suchen und dann auf „Code“ (Schaltfläche „{}“) klicken, um den JSON-Code zu bearbeiten.

Informationen zum Definieren von Parametern und Verweisen auf den Parameter mithilfe von @{linkedService().paramName} finden Sie im Abschnitt mit dem JSON-Beispiel zum Hinzufügen von parameters.

Benutzeroberfläche

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

Zugehöriger Inhalt

Speichern von Anmeldeinformationen in Azure Key Vault