Azure Synapse Analytics-Verbindung

Einführung

Eine Azure Synapse Analytics-Verbindung, die mit dem Azure Synapse Analytics-Connector erstellt wurde, ermöglicht den Zugriff auf Azure Synapse Analytics. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Azure Synapse Analytics.

Erstellen oder Bearbeiten einer Azure Synapse Analytics-Verbindung

Eine neue Azure Synapse Analytics-Verbindung wird mit dem Azure Synapse Analytics-Connector aus einem dieser Standorte erstellt:

Der Registerkarte Projektendpunkte und -connectoren in der Designkomponenten-Palette (siehe Designkomponenten-Palette).
Der Seite Globale Endpunkte (siehe Erstellen eines globalen Endpunkts in Globalen Endpunkten).

Eine vorhandene Azure Synapse Analytics-Verbindung kann von diesen Standorten aus bearbeitet werden:

Der Registerkarte Projektendpunkte und -connectoren in der Designkomponenten-Palette (siehe Designkomponenten-Palette).
Der Registerkarte Komponenten im Projektbereich (siehe Aktionenmenü für Komponenten in Projektbereich Komponenten-Registerkarte).
Der Seite Globale Endpunkte (siehe Bearbeiten eines globalen Endpunkts in Globalen Endpunkten).

Konfigurieren einer Azure Synapse Analytics-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Azure Synapse Analytics-Verbindung wird im Folgenden beschrieben.

Tipp

Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Azure Synapse Analytics-Verbindung eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den Azure Synapse Analytics-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.
Server: Geben Sie den Server ein.
Verschlüsseln: Wählen Sie die Verschlüsselung aus, eine der Optionen Wahr, Falsch oder Streng.
Authentifizierungsschema: Wählen Sie das Authentifizierungsschema aus, eines von:
- Passwort
  - Benutzer: Geben Sie den Benutzer ein.
  - Passwort: Geben Sie das Passwort ein.
- AzureAD
  - OAuth initiieren: Wählen Sie die OAuth-Einstellung aus, eine der Optionen:
    - AUS
      - OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
    - AKTUALISIEREN
      - OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
    - HOLENUNDAKTUALISIEREN
  - Bereich: Geben Sie den Bereich ein.
  - OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.
- AzureServicePrincipal
  - Azure-Mandant: Geben Sie den Azure-Mandanten ein.
  - OAuth initiieren: Wählen Sie die OAuth-Einstellung aus, eine der Optionen:
    - AUS
      - OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
    - AKTUALISIEREN
      - OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
    - HOLENUNDAKTUALISIEREN
  - OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.
  - OAuth-Client-Geheimnis: Geben Sie das OAuth-Client-Geheimnis ein.
  - Bereich: Geben Sie den Bereich ein.
  - OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.
- AzureServicePrincipalCert
  - Azure-Mandant: Geben Sie den Azure-Mandanten ein.
  - OAuth initiieren: Wählen Sie die OAuth-Einstellung aus, eine der Optionen:
    - AUS
      - OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
    - AKTUALISIEREN
      - OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
    - GETANDREFRESH
  - OAuth Client ID: Geben Sie die OAuth-Client-ID ein.
  - Scope: Geben Sie den Scope ein.
  - OAuth Refresh Token: Geben Sie das OAuth-Refresh-Token ein.
  - OAuth JWT Cert: Geben Sie das OAuth-JWT-Zertifikat ein.
  - OAuth JWT Cert Type: Wählen Sie den Typ des OAuth-JWT-Zertifikats aus, einen der USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB, BCFKSFILE oder BCFKSBLOB.
  - OAuth JWT Cert Password: Geben Sie das Passwort für das OAuth-JWT-Zertifikat ein.
  - OAuth JWT Cert Subject: Geben Sie das Subjekt des OAuth-JWT-Zertifikats ein.
- AzureMSI
- AzurePassword
  - User: Geben Sie den Benutzer ein.
  - Password: Geben Sie das Passwort ein.
  - Azure Tenant: Geben Sie den Azure-Mandanten ein.
Port: Geben Sie den Port ein.
Database: Geben Sie die Datenbank ein.
Use Proxy Settings: Wählen Sie aus, um die Proxy-Einstellungen des privaten Agenten zu verwenden.
Advanced Configurations: Wenn ausgewählt, wird die Tabelle Advanced Configurations Properties angezeigt, die verwendet wird, um zusätzliche Konfigurationseigenschaften als Schlüssel-Wert-Paare hinzuzufügen.
- Add: Fügt eine Zeile zur Tabelle hinzu. Geben Sie ein Schlüssel-Wert-Paar für jede Eigenschaft ein.
- Submit: Speichert das Schlüssel-Wert-Paar in der Tabelle. Sichtbar beim Überfahren einer Zeile im Bearbeitungsmodus.
- Discard: Verwirft eine neue Zeile oder alle Änderungen an einer vorhandenen Zeile. Sichtbar beim Überfahren einer Zeile im Bearbeitungsmodus.
- Edit: Ermöglicht das Bearbeiten eines vorhandenen Schlüssel-Wert-Paares. Sichtbar beim Überfahren einer vorhandenen Zeile.
- Delete: Löscht die Zeile aus der Tabelle. Sichtbar beim Überfahren einer vorhandenen Zeile.
- Clear All: Löscht alle Zeilen aus der Tabelle.
Wichtig

Felder in der Tabelle Erweiterte Konfigurationsparameter zeigen das Variablen-Icon nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agenten-Version mindestens 10.75 / 11.13 sein.

Felder in der Tabelle Erweiterte Konfigurationsparameter unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird {"success": "true"}; zu {\"success\": \"true\"};.
Test: Klicken Sie, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.
Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.
Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.
Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine Verbindung zu einem Azure Synapse Analytics-Connector erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfstafel, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und deren Aktivitätstypen sind im Projektbereich und in der Designkomponentenpalette zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

Abfrage: Ruft Datensätze aus einer Tabelle in Azure Synapse Analytics ab und ist als Quelle in einem Vorgang vorgesehen.
Erstellen: Fügt einen Datensatz in eine Tabelle in Azure Synapse Analytics ein und ist als Ziel in einem Vorgang vorgesehen.
Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle in Azure Synapse Analytics und ist als Ziel in einem Vorgang vorgesehen.
Löschen: Löscht einen Datensatz aus einer Tabelle in Azure Synapse Analytics und ist als Ziel in einem Vorgang vorgesehen.
Ausführen: Führt eine Prozedur in Azure Synapse Analytics aus und ist als Ziel in einem Vorgang vorgesehen.