SQL Server

Microsoft SQL Server ist ein relationales Datenbankverwaltungssystem, das von Microsoft entwickelt wurde. Stellen Sie eine Verbindung mit SQL Server her, um Daten zu verwalten. Sie können verschiedene Aktionen wie Erstellen, Aktualisieren, Abrufen und Löschen für Zeilen in einer Tabelle ausführen.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung	Class	Regions
Copilot Studio	Premium	Alle Power Automate-Regionen
Logik-Apps	Norm	Alle Logik-Apps-Regionen
Power Apps	Premium	Alle Power Apps-Regionen
Power Automate	Premium	Alle Power Automate-Regionen

Connectormetadaten
Herausgeber	Microsoft

Verbinder im Detail

In diesem Artikel werden die Vorgänge für den verwalteten SQL Server-Connector beschrieben, der für Azure Logic Apps, Power Automate und Power Apps verfügbar ist. Der integrierte SQL Server-Connector ist nur für Standardlogik-App-Workflows in Azure Logic Apps verfügbar.

• Weitere Informationen zu diesem Connector in Power Apps finden Sie unter Herstellen einer Verbindung mit SQL Server aus Power Apps.
• Weitere Informationen zum integrierten SQL Server-Connector und verwalteten Connector in Azure Logic Apps finden Sie unter Herstellen einer Verbindung mit SQL-Datenbanken aus Workflows in Azure Logic Apps.

Authentifizierung

Wenn Sie Nicht-Microsoft Entra ID (Microsoft Entra ID)-Verbindungen erstellen möchten, verwenden Sie die Option für die Verbindungszeichenfolgenauthentifizierung. Stellen Sie sicher, dass Sie dieselben Servernamen und Datenbanknamenwerte wie in Ihrer Verbindung definiert angeben.

Microsoft Entra ID-Authentifizierung

Bekannte Einschränkungen bei der Microsoft Entra ID-Authentifizierung

Aufgrund der aktuellen Einschränkungen der Authentifizierungspipeline werden Gastbenutzer von Microsoft Entra ID für Microsoft Entra ID-Verbindungen zu SQL Server nicht unterstützt. Um dieses Problem zu beheben, verwenden Sie stattdessen die SQL Server-Authentifizierung oder windows-Authentifizierung.

Aktivieren der Microsoft Entra ID-Authentifizierung für SQL Server

1. Richten Sie Ihr Konto als SQL Microsoft Entra ID (Microsoft Entra ID)-Mitglied ein, und stellen Sie es bereit. Weitere Informationen finden Sie unter Konfigurieren und Verwalten der Microsoft Entra ID-Authentifizierung mit Azure SQL.

2. Richten Sie auf Ihrem SQL Server Ihren Microsoft Entra ID-Administrator ein.

   1. Wechseln Sie im Azure-Portal zum SQL-Server, auf dem Sie die Microsoft Entra ID-Authentifizierung aktivieren möchten.
   2. Wählen Sie im Sql Server-Ressourcenmenü unter "Einstellungen" die Option "Microsoft Entra-ID" aus.
   3. Wählen Sie auf der Symbolleiste des Microsoft Entra-ID-Bereichs"Administrator festlegen" aus.
   4. Suchen Und wählen Sie ein Microsoft Entra ID-Benutzerkonto im aktuellen Mandanten aus, um sie zu einem Serveradministrator zu machen. Speichern Sie Ihre Änderungen.

3. Erstellen und registrieren Sie in Ihrem Microsoft Entra ID-Mandanten eine Microsoft Entra ID-Anwendung für den Zugriff auf Ihre SQL-Datenbank. Weitere Informationen finden Sie unter SQL Server – Einrichten der Microsoft Entra ID-Authentifizierung.

   1. Wechseln Sie im Azure-Portal zu Ihrem Microsoft Entra ID-Mandanten, in dem Sie die Microsoft Entra ID-Anwendung erstellen möchten.

   2. Wählen Sie im Mandantenmenü unter "Verwalten" die Option "App-RegistrierungenNeue Registrierung"> aus.

   3. Geben Sie im Bereich "Anwendung registrieren " einen Namen für die Anwendung an. Denken Sie an diesen Namen, damit Sie später einen Benutzer erstellen und Ihrer SQL-Datenbank Rollenzugriff gewähren können.

   4. Wenn Sie fertig sind, wählen Sie "Registrieren" aus, wodurch die Microsoft Entra-ID-Anwendung erstellt wird.

   5. Wählen Sie im Bereich "App-Registrierungen " Ihre neue Microsoft Entra-ID-Anwendung aus. Wählen Sie im Anwendungsmenü Zertifikate und geheime Schlüssel>"Neuer geheimer Clientschlüssel" aus.

   6. Geben Sie eine Beschreibung für den geheimen Schlüssel an, und wählen Sie einen Ablauf aus.

4. Melden Sie sich bei Ihrem SQL Server und ihrer Datenbank mit den Anmeldeinformationen für das Microsoft Entra ID-Benutzerkonto an, das Sie als Serveradministrator eingerichtet haben.

5. Erstellen Sie in Ihrer SQL-Datenbank einen enthaltenen Benutzer, der die Microsoft Entra-ID-Anwendung darstellt. Für diesen Schritt ist Microsoft SQL Server Management Studio (SSMS) erforderlich.

   Mit den folgenden Schritten werden die Rollen der db_datareaderdb_datawriter Microsoft Entra ID-Anwendung mit dem Namen example-Azure-AD-application-namezugewiesen. Wenn Sie die angegebenen Befehle ausführen, denken Sie daran, den Namen für Ihre Microsoft Entra ID-Anwendung durch den Namen zu ersetzen example-Azure-AD-application-name und die erforderlichen Rollen für Ihre Anforderungen zuzuweisen.

   1. Starten Sie SSMS, und stellen Sie eine Verbindung mit dem SQL-Server her, auf den die Microsoft Entra ID-Anwendung zugreifen wird.

   2. Verwenden Sie in der AuthentifizierungActive Directory – Universell mit MFA-Unterstützung und dem Microsoft Entra ID-Konto, das Sie als Serveradministrator eingerichtet haben.

   3. Erweitern Sie im Objekt-Explorer den Ordner "Datenbanken ".

   4. Suchen Sie Ihre Datenbank, öffnen Sie das Kontextmenü der Datenbank, und wählen Sie "Neue Abfrage" aus.

   5. Führen Sie im Abfragefenster den folgenden Befehl aus, um die Microsoft Entra ID-Anwendung mit einem neuen Benutzer in der Datenbank zu verknüpfen:

      CREATE USER [example-Azure-AD-app-name] FROM EXTERNAL PROVIDER
      

   6. Löschen Sie das Abfragefenster. Führen Sie dann den folgenden Befehl aus, um die db_datareader Rolle der Microsoft Entra ID-Anwendung zuzuweisen:

      ALTER ROLE db_datareader ADD MEMBER [example-Azure-AD-application-name]
      

   7. Wiederholen Sie den vorherigen Schritt, um die db_datawriter Rolle der Microsoft Entra ID-Anwendung zuzuweisen:

      ALTER ROLE db_datawriter ADD MEMBER [example-Azure-AD-application-name]
      

Authentifizierung der verwalteten Identität

Derzeit unterstützt nur Azure Logic Apps die verwaltete Identitätsauthentifizierung für den SQL Server-Connector.

Dienstprinzipalauthentifizierung

Einrichten der verwalteten Identität in Ihrer Logik-App

1. Wechseln Sie im Azure-Portal zu Ihrer Logik-App-Ressource.

2. Aktivieren Sie entweder die vom System zugewiesene Identität oder die vom Benutzer zugewiesene Identität. Wenn Sie nicht über eine vom Benutzer zugewiesene Identität verfügen, müssen Sie zuerst diese Identität erstellen. Weitere Informationen finden Sie unter Authentifizieren des Zugriffs auf Azure-Ressourcen mit verwalteten Identitäten in Azure Logic Apps.

3. Wenn Sie die vom Benutzer zugewiesene Identität ausgewählt haben, stellen Sie sicher, dass Sie diese Identität zu Ihrer Logik-App-Ressource hinzugefügt haben.

   1. Navigieren Sie im Azure-Portal zu der Logik-App-Ressource, in der Sie die verwaltete Identität verwenden möchten.
   2. Wählen Sie im Navigationsmenü der Logik-App unter " Einstellungen" die Option "Identität" aus.
   3. Wählen Sie auf der Registerkarte Benutzerseitig zugewiesen die Option Hinzufügen aus.
   4. Wählen Sie die zu verwendende verwaltete Identität und dann "Hinzufügen" aus.

Einrichten von SQL Server für die Authentifizierung verwalteter Identitäten

1. Richten Sie auf Ihrem SQL Server Ihren Microsoft Entra ID-Administrator ein.

   1. Navigieren Sie im Azure-Portal zum SQL-Server, auf dem Sie die Microsoft Entra ID-Authentifizierung aktivieren möchten.
   2. Wählen Sie im Sql Server-Ressourcenmenü unter "Einstellungen" die Option "Microsoft Entra-ID" aus.
   3. Wählen Sie auf der Symbolleiste des Microsoft Entra-ID-Bereichs"Administrator festlegen" aus.
   4. Suchen Und wählen Sie ein Microsoft Entra ID-Benutzerkonto im aktuellen Mandanten aus, um sie zu einem Serveradministrator zu machen. Speichern Sie Ihre Änderungen.

2. Erstellen Sie in Ihrer SQL-Datenbank einen enthaltenen Benutzer, um die verwaltete Identität darzustellen. Für diesen Schritt ist Microsoft SQL Server Management Studio (SSMS) erforderlich.

   Die folgenden Schritte weisen die Rolle db_datareader einer verwalteten Identität mit dem Namen example-managed-identity-namezu. Wenn Sie die angegebenen Befehle ausführen, denken Sie daran, den Namen für Ihre verwaltete Identität zu ersetzen example-managed-identity-name und die richtige Rolle für Ihre Anforderungen zuzuweisen. Beispielsweise db_datareader können Keine Schreibvorgänge ausgeführt werden.

   1. Starten Sie SSMS, und stellen Sie eine Verbindung mit dem SQL-Server her, auf den die verwaltete Identität zugreift.

   2. Verwenden Sie in der AuthentifizierungActive Directory – Universell mit MFA-Unterstützung und dem Microsoft Entra ID-Konto, das Sie als Serveradministrator eingerichtet haben.

   3. Erweitern Sie im Objekt-Explorer den Ordner "Datenbanken ".

   4. Suchen Sie Ihre Datenbank, öffnen Sie das Kontextmenü der Datenbank, und wählen Sie "Neue Abfrage" aus.

   5. Führen Sie im Abfragefenster den folgenden Befehl aus, um die verwaltete Identität mit einem neuen Benutzer in der Datenbank zu verknüpfen:

      CREATE USER [example-managed-identity-name] FROM EXTERNAL PROVIDER
      

   6. Löschen Sie das Abfragefenster. Führen Sie dann den folgenden Befehl aus, um der Verwalteten Identität eine Rolle zuzuweisen:

      ALTER ROLE db_datareader ADD MEMBER [example-managed-identity-name]
      

      Hinweis

      Wenn Sie der verwalteten Identität auf Datenbankebene Rollen zuweisen, verfügt die Identität nicht über die erforderlichen Bereiche, um alle Datenbanken auflisten zu können. Wenn Sie aus der Datenbanknamenliste in einem SQL-Auslöser oder einer Aktion auswählen, erhalten Sie einen Fehler wie im folgenden Beispiel:

      Couldn't retrieve values. Error code: 'Unauthorized', Message: 'Credentials are missing or not valid'.
      Inner exception: The credentials provided for the SQL source are invalid
      

      Um dieses Problem zu beheben, haben Sie die folgenden Optionen:

      • Weisen Sie eine Rolle auf Serverebene zu, die alle Datenbanken der verwalteten Identität auflisten kann.
      • Geben Sie im SQL-Auslöser oder der Aktion den Datenbanknamen mithilfe der Option "Benutzerdefinierten Wert eingeben " ein.

Weitere Informationen finden Sie in der folgenden Dokumentation:

• Authentifizieren des Zugriffs auf Azure-Ressourcen mithilfe von verwalteten Identitäten in Azure Logic Apps
• Lernprogramm: Verwenden einer vom Windows-VM-System zugewiesenen verwalteten Identität für den Zugriff auf Azure SQL
• Konfigurieren und Verwalten der Microsoft Entra ID-Authentifizierung mit Azure SQL
• Rollen auf Datenbankebene
• Rollen auf Serverebene

Unterstützung von Virtual Network

Wenn der Connector in einer Power Platform-Umgebung verwendet wird, die mit einem Virtual Network verknüpft ist, gelten Einschränkungen:

• Die folgenden Aktionen sind die einzigen unterstützten Aktionen:

  • Zeile löschen (V2)
  • Ausführen einer SQL-Abfrage (V2)
  • Zeile abrufen (V2)
  • Abrufen von Zeilen (V2)
  • Abrufen von Tabellen (V2)
  • Zeile einfügen (V2)
  • Zeile aktualisieren (V2)
  • Ausgeführte gespeicherte Prozedur (V2)

• Jede Aktion außerhalb dieser Liste gibt einen Fehler "403 Nicht autorisiert" zurück.

• Lokales Datengateway wird nicht unterstützt

• Wenn Sie die integrierte Microsoft Entra ID-Authentifizierung verwenden, geben Sie den Datenbanknamen manuell als benutzerdefinierter Wert ein.

Bekannte Probleme und Einschränkungen mit Aktionen

Kurzbeschreibung	Operationen	Lange Beschreibung
Abrufen von deterministischen Ergebnissen in einer Aktionsausgabe	Abrufen von Zeilen (V2)	Die Verwendung des Parameters wird empfohlen, um deterministische Ergebnisse in der Order By Aktionsausgabe abzurufen. Wenn Order By nicht angegeben, werden Primärschlüssel oder eindeutige Schlüssel standardmäßig von SQL Server verwendet. Nicht deterministische Ergebnisse können Probleme verursachen, z. B. das Duplizieren von Datensätzen in der Aktionsausgabe, wenn die Paginierung aktiviert ist. SQL-Ansichten unterstützen keinen Primärschlüssel, was die Einschränkung von SQL Server selbst ist.
Ausführen einer eingeschränkten SQL-Abfrageunterstützung	Ausführen einer SQL-Abfrage (V2)	Wird für lokale SQL Server nicht unterstützt.
Allgemeine CRUD-Anforderungen	Zeile abrufen (V2) Abrufen von Zeilen (V2) Zeile aktualisieren (V2) Zeile löschen (V2)	Zeichenfolgenwerte werden im Fall der Azure SQL-Instanzverwendung gekürzt. Daher werden leere Zeichenfolgen in leere Zeichenfolgen konvertiert. Bei INSERT- und UPDATE-Vorgängen gibt der Connector die aktualisierten Zeilen zurück. Dies erfordert, dass die Verbindung auch über die Berechtigung zum Lesen von Daten aus sql Server verfügen muss. Für die folgenden Vorgänge ist ein Primärschlüssel erforderlich: - GetItem - PatchItem - DeleteItem
Unterstützung des Aggregationstransformationsparameters	Abrufen von Zeilen (V2)	Nur die folgenden Aggregationstransformationen werden unterstützt: - filter: Ermöglicht das Filtern des Eingabesatzes. Unterstützt dieselben Ausdrücke wie $filter. Beispiel: filter(ColName1 eq 1). - Aggregat: Ermöglicht die Aggregation mithilfe einer der folgenden Methoden: average, , max, min, sum. countdistinct Beispiel: aggregate(ColName2 with max as MaxValue). Sie können mehrere Operatoren kombinieren, die durch Schrägstriche getrennt sind, um auszudrücken, dass sie aufeinander folgenden angewendet werden. Dies bedeutet, dass das Ergebnis jeder Transformation die Eingabe für die nächste Transformation ist. Beispiel: filter(ColName1 eq 4)/aggregate(ColName2 with sum as MaxWorkItemId).
Der Datentyp des formalen Parameters wird beim Ausführen einer SQL-Abfrage außer Kraft gesetzt.	Ausführen einer SQL-Abfrage [VERALTET] Ausführen einer SQL-Abfrage (V2)	Der datentyp, der beim Definieren eines formalen Parameters für eine SQL-Abfrage eingegeben wird, kann überschrieben werden, da die zugrunde liegende Implementierung des Connectors den Typ über den angegebenen Wert des Parameters bestimmt.
FÜR DEN IN-Operator, der formale Parameter verwendet, müssen werte separat definiert werden.	Ausführen einer SQL-Abfrage (V2)	Beim Verwenden formaler Parameter mit dem IN-Operator müssen alle übergebenen Werte separat definiert werden, anstatt als ein einzelner formaler Parameter, der mehrere kommagetrennte Werte enthält. Beispiel: SELECT * FROM tableName WHERE columnName IN (@formalParameterA, @formalParameterB, @formalParameterC).
Fehler bei Verwendung von Azure Sql DataWareHouse DB	Zeile einfügen (V2)	Die Verwendung von Azure SQL Datawarehouse DB in Power Apps führt zu einem Fehler aufgrund eines Syntaxkonflikts bei der Ausführung des Connectors auf der DB. Erstellen Sie einen Fluss mit dem Azure SQL Datawarehouse-Connector in Power Automate, lösen Sie ihn aus PowerApps aus, oder erstellen Sie eine Abfrage, und verwenden Sie ihn in der Aktion "Ausführen einer SQL-Abfrage (V2) ".

Bekannte Probleme und Einschränkungen mit Triggern

Hinweis

Wenn Sie einen Fluss deaktivieren und aktivieren, wird der Triggerzustand nicht zurückgesetzt.

Kurzbeschreibung	Operationen	Lange Beschreibung
Ändern eines Elements: Zeilenvorgänge	Wenn ein Element geändert wird (V2)	Wird sowohl bei INSERT- als auch bei AKTUALISIERUNGszeilenvorgängen ausgelöst.
Ändern eines Elements: Spaltenanforderungen	Wenn ein Element geändert wird (V2)	Eine ROWVERSION-Spalte ist erforderlich.
Erstellen eines Elements: Spaltenanforderung	Beim Erstellen eines Elements (V2)	Es ist eine IDENTITY-Spalte erforderlich.
Erstellen eines Elements	Beim Erstellen eines Elements (V2)	Verwenden Sie den Identitätsspaltenwert der letzten eingefügten Zeile als Schwellenwert (Triggerstatus), um neu eingefügte Zeilen später zu identifizieren. Die Logik setzt voraus, dass die Identität jeder neuen Zeile größer sein muss als die vorherige. Daher wird die Identitätssequenz für eine Tabelle aufgrund expliziter t-sql-Befehle oder Tabellenabkürzung zurückgesetzt, löst die Triggerlogik neue Zeilen für den vorhandenen Fluss aus. Es gibt zwei verschiedene Problemumgehungen: Zuerst können Sie den Ablauftriggerstatus zurücksetzen, indem Sie die Triggeraktionskarte aktualisieren (z. B. umbenennen, Parameter aktualisieren oder eine neue Verbindung hinzufügen), und die Änderungen speichern. Alternativ können Sie die Zieltabellenidentitätssequenz mithilfe des folgenden Ansatzes wiederherstellen.

Allgemeine bekannte Probleme und Einschränkungen

• Das Einfügen und Aktualisieren in eine Tabelle funktioniert nicht, wenn Sie einen sql serverseitigen Auslöser für die Tabelle definiert haben.

  Um dieses Problem zu beheben, haben Sie die folgenden Optionen:

  • Verwenden Sie eine gespeicherte Prozedur oder systemeigene Abfrage.
  • Entfernen Sie den Auslöser aus der SQL-Tabelle.

• Die folgenden Einschränkungen gelten für die Verwendung des SQL-Connectors mit einem lokalen SQL-Server:

  • Die mindestens unterstützte Version für lokale SQL Server ist SQL Server 2005.
  • Die Anforderungsgrößenbeschränkung beträgt 2 MB über lokale SQL Server.
  • Der Grenzwert für die Antwortgröße beträgt 8 MB bis zur lokalen SQL Server-Bereitstellung.

• Die folgenden Einschränkungen gelten für das Aufrufen einer gespeicherten Prozedur auf einem lokalen SQL-Server über ein Gateway:

  • Ausgabewerte für OUTPUT Parameter werden nicht zurückgegeben. Sie können weiterhin Eingabewerte für OUTPUT Parameter angeben.
  • ResultSets-Wert ist untypiert.
  • Rückgabewert ist nicht verfügbar.
  • Es wird nur der erste Resultset zurückgegeben.
  • Dynamics-Schemas werden für Resultsets nicht unterstützt.

• Die folgenden Datentypen können nicht als Abfrageoptions-Prädikate verwendet werden:

  • date
  • datetime
  • datetime2
  • smalldatetime

• Das Festlegen der Erzwingungsverschlüsselung wird nicht unterstützt. Standardmäßig sichern SQL-Datenbank und SQL Managed Instance Kundendaten durch Verschlüsseln von Daten in Bewegung mit Transport Layer Security (TLS). Weitere Informationen finden Sie in der Übersicht über die Azure SQL-Sicherheit.

• Die Unterstützung mehrerer Resultsets ist derzeit für die sql native Abfrageausführung eingeschränkt. Es werden nur Ergebnissätze bis zum ersten leeren Resultset zurückgegeben.

  Verwenden Sie gespeicherte Prozeduren, um dieses Problem zu beheben.

• Nachdem SQL-Abfragen und gespeicherte Prozeduren ausgeführt wurden, sollte das Resultsetschema eindeutige, nicht leere Spaltennamen enthalten.

• Für alle Vorgänge innerhalb der gespeicherten Prozedur, die eine Reihe von Ergebnissen zurückgibt, z. B. jede innere SELECT Anweisung, sollte das Resultsetschema eindeutige, nicht leere Spaltennamen enthalten.

• Wenn die Ausführungszeit für eine SQL-Abfrage oder gespeicherte Prozedur 110 Sekunden überschreitet, wird ein Timeout für Aktionen ausgeführt.

  In Azure Logic Apps, um diese Einschränkung zu umgehen und zu erfahren, wie lange ausgeführte gespeicherte Prozeduren ausgeführt werden, finden Sie unter Long-running SQL gespeicherte Prozeduren in Logic Apps.

• In Azure Logic Apps können Sie nur in einer Integrationsdienstumgebung (ISE) auf den privaten Endpunkt auf SQL Server zugreifen. Weitere Informationen finden Sie unter Zugriff auf virtuelle Azure-Netzwerke.

• Beim Erstellen einer Abfrage mit vielen Filtern kann der folgende Fehler auftreten: "OData-Abfragesyntaxstruktur hat die Anzahl der Knoten von '100' überschritten. Bitte versuchen Sie, OData-Abfrageparameterausdrücke zu vereinfachen". Um dieses Problem zu vermeiden, optimieren Sie die Filterbedingungen, um ihre Anzahl zu verringern (z. B. mithilfe von Bereichen).

• Es wird nicht empfohlen, große Datenmengen (mehr als 30 MB) in den Zieltabellenfeldern (e.g. xml oder Textdatentypen) zu speichern. Dies kann zu einer Leistungsbeeinträchtigung von Aktionen und Triggern führen, was zu 504 Timeoutfehlern führt. Verwenden Sie den Parameter 'Select Query', um nur relativ kleine Felder einzuschließen und große Ausgabedatenfelder zu vermeiden. Oder verwenden Sie stattdessen spezielle Dateispeicher, z. B. Azure Blob Storage.

• CRUD-Vorgänge werden für Azure Synapse-Quellen aufgrund fehlender OUTPUT-Klauselnunterstützung nicht unterstützt. Es wird dringend empfohlen, stattdessen dedizierten Azure SQL Data Warehouse-Connector zu verwenden.

• Power Platform- und Logic Apps-Navigatoransichten sind auf eine Listengröße von 10.000 Tabellen beschränkt.

• Datenbankschema, das nicht den OData-Standardbezeichnern entspricht, wird nicht unterstützt (Spaltenname beginnend mit Zahl, enthaltenden Ersatzpaarzeichen usw.). Kunden können entweder eine Ansicht verwenden, um den Namen der Spalten abzustrahieren, oder sie können SQL Extended-Eigenschaften verwenden, um die Verwendung von ergänzenden Ebenenzeichen zu behandeln, die sie vom Datenbankschema getrennt halten, siehe: Hinzufügen einer erweiterten Eigenschaft zu einer Spalte in einer Tabelle.

• Wenn Sie den SQL-Connector als Datenquelle für virtuelle Tabellen verwenden, müssen die Server- und Datenbankwerte zwischen dem Quelldatensatz und der verwendeten Verbindung übereinstimmen. Bei Verwendung der SQL-Authentifizierung können die Datasetwerte standardmäßig festgelegt werden, da die Verbindung bereits Server- und Datenbankwerte enthält. Wenn Datensetverbindungswerte explizit angegeben werden, müssen sie mit denen der Verbindung übereinstimmen, andernfalls sind Fehler wie "Da ist ein Fehler aufgetreten. Wir konnten Ihre Tabelle nicht öffnen. Versuchen Sie, die Datei neu zu laden oder erneut zu öffnen." oder "Ungültige Datenquelle" kann auftreten.

• Wenn Schemaänderungen an Ansichten auftreten, die in Power Automate-Flüssen verwendet werden, werden Auslöser möglicherweise erst ausgelöst, wenn eine neue Verbindung mit der aktualisierten Ansicht erstellt wird. Nur das Aktualisieren der Verbindung reicht nicht aus, um den Trigger für aktualisierte Ansichten zurückzusetzen.

• Das TDS-Protokoll (Tabular Data Stream) 8.0 wird derzeit vom SQL-Connector nicht unterstützt.

Besondere Einschränkungsgrenzwerte

• In verschiedenen Fällen weist der SQL-Connector unterschiedliche Einschränkungsgrenzwerte auf. In der folgenden Tabelle enthalten systemeigene Vorgänge die gespeicherte SQL-Prozedur und SQL-Abfrage. CRUD steht für Erstellungs-, Lese-, Aktualisierungs- und Löschvorgänge.

• Zusammen mit den folgenden Grenzwerten wird auch die Einschränkung der Verbindungs-ID-Ebene basierend auf der Gesamtzeit angewendet, die von vorherigen Anforderungen in einem bestimmten Zeitraum verbracht wurde.

Dienstleistung	Umwelt	Operationen	Name	Calls	Verlängerungszeitraum (Sekunden)
Logik-Apps und Power Automate	Freigegebene Umgebung	Einheimisch	API-Aufrufe pro Verbindung	500	10
Logik-Apps und Power Automate	Freigegebene Umgebung	CRUD	API-Aufrufe pro Verbindung	100	10
Logik-Apps und Power Automate	Freigegebene Umgebung	Einheimisch	Gleichzeitige Anrufe pro Verbindung	200	-
Logik-Apps und Power Automate	Freigegebene Umgebung	CRUD	Gleichzeitige Anrufe pro Verbindung	125	-
Power Apps	Freigegebene Umgebung	All	API-Aufrufe pro Benutzer	300	30
Power Apps	Freigegebene Umgebung	All	Gleichzeitige Anrufe pro Verbindung	125	-

Hinweis

Gleichzeitige Anrufe sind die Anzahl der laufenden Anforderungen, die eine bestimmte Verbindung herstellen kann. Bei nativen Azure Logic Apps-Aufrufen kann beispielsweise eine einzelne Verbindung 200 gleichzeitige Anrufe tätigen. Alle nachfolgenden Aufrufe geben einen 429-Fehler zurück, wenn alle 200 Aufrufe noch ausgeführt werden. Es ist kein Zeitlimit vorhanden, da die Anrufe beliebig lange dauern können. Der Punkt des Aufruflimits besteht jedoch darin, zu viele lange ausgeführte Abfragen von einer einzigen Verbindung zu verhindern und andere Verbindungen negativ zu beeinflussen.

Wenn beispielsweise eine Verbindung 200 Aufrufe gleichzeitig durchführt und jeder Anruf 50 Sekunden dauert, bis alle anderen Anrufe ausgeführt werden, schlägt für die nächsten 50 Sekunden ein 429-Fehler fehl. Nachdem eine oder mehrere Abfragen die Ausführung abgeschlossen haben und Ergebnisse zurückgegeben werden, werden alle nachfolgenden Aufrufe verarbeitet.

Power Apps-Datentypzuordnungen

Weitere Informationen finden Sie in der Power Apps SQL-Dokumentation

Power Apps-Funktionen und -Vorgänge, die an SQL Server delegierbar sind

Weitere Informationen finden Sie in der Dokumentation zur SQL-Delegierung von Power Apps

Formale Parameter in Vorgängen

Ausführen einer SQL-Abfrage [VERALTET] und Ausführen einer SQL-Abfrage (V2) -Aktionen ermöglichen die Verwendung formaler Parameter. Sie werden als Schlüsselwertpaare definiert, wobei key es sich um den Parameternamen und value den SQL-Datentyp handelt, z INT . B. oder NVARCHAR(255). Nachdem Sie den Namen und den Datentyp definiert haben, wird ein neues Eingabefeld für den Wert angezeigt.

Migrieren von V1-Vorgängen zu V2-Äquivalenten

Führen Sie die hier beschriebenen Schritte aus, um von einem V1-Vorgang zu seinem V2-Äquivalent zu migrieren.

Von Bedeutung

Bevor Sie die Migration starten, speichern Sie immer eine Kopie Ihrer Logik-App, des Power Automate-Flusses oder der Power App, um über eine Sicherung zu verfügen.

Hinweis

Alle V2-Vorgänge weisen zwei zusätzliche Parameter auf: Server Nameund Database Name. Dadurch können V2-Vorgänge Microsoft Entra-ID-Authentifizierungen unterstützen.

Typ des Vorgangs	V1-Vorgang	V2-Vorgangsäquivalent
Maßnahme	Zeile löschen [VERALTET]	Zeile löschen (V2)
Maßnahme	Ausführen einer SQL-Abfrage [VERALTET]	Ausführen einer SQL-Abfrage (V2)
Maßnahme	Ausführen einer gespeicherten Prozedur	Ausgeführte gespeicherte Prozedur (V2)
Maßnahme	Zeile abrufen [VERALTET]	Zeile abrufen (V2)
Maßnahme	Abrufen von Zeilen [VERALTET]	Abrufen von Zeilen (V2)
Maßnahme	Zeile einfügen [VERALTET]	Zeile einfügen (V2)
Maßnahme	Listet Tabellen auf, die von der Verbindung verfügbar gemacht werden [VERALTET]	Abrufen von Tabellen (V2)
Maßnahme	Zeile aktualisieren [VERALTET]	Zeile aktualisieren (V2)
Auslöser	Wenn ein Element erstellt wird [VERALTET]	Beim Erstellen eines Elements (V2)
Auslöser	Wenn ein Element geändert wird [VERALTET]	Wenn ein Element geändert wird (V2)

Identifizieren von V1-Aktionen

Power Automate

Öffnen Sie für Power Automate-Vorgänge die SQL Server-Vorgänge Code View , und überprüfen Sie den host.operationId Wert. Wenn der Wert mit einer der oben aufgeführten SQL Server V1-Vorgangs-IDs übereinstimmt, muss dieser Vorgang zu seiner V2-Entsprechung migriert werden.

Der Vorgang muss z PatchItem . B. zu PatchItem_V2.

Logic Apps

So erhalten Sie einen Überblick über die Logik-Apps, die mindestens einen SQL Server V1-Vorgang enthalten:

1. Öffnen des Azure-Portals

2. Öffnen des Azure Resource Graph-Explorers

3. Geben Sie Ihre Abonnement-ID in den Platzhalter ein, und führen Sie die folgende Abfrage aus, um eine Zusammenfassung der Logik-Apps zu erhalten, die Ihre Aufmerksamkeit benötigen, und die Anzahl der SQL Server V1-Aktionen in jedem dieser Aktionen.

   • Azure Resource Graph-Explorer-Skript zum Identifizieren von Logik-Apps mit V1-Aktionen.

     resources
     | where subscriptionId == "<subscription-id>"
     | where type == "microsoft.logic/workflows"
     | extend propertiesJson=parse_json(properties)
     | extend actionsJson=propertiesJson["definition"]["actions"]
     | mv-expand actionsJson
     | where notnull(actionsJson)
     | extend path=extract("\"path\":\"(.*?)\"", 1, tostring(actionsJson))
     | where notnull(path) and path startswith "/datasets/default/"
     | extend actionConnectionName=extract("\"connection\":{\"name\":\"(.*?)\"}", 1, tostring(actionsJson))
     | where notnull(actionConnectionName)
     | parse actionConnectionName with "@parameters('$connections')['"parsedActionConnectionName"']['connectionId']"
     | extend tmpConnection = propertiesJson["parameters"]["$connections"]["value"][parsedActionConnectionName]
     | where notnull(tmpConnection)
     | extend connectionId=extract("\"id\":\"(.*?)\"", 1, tostring(tmpConnection))
     | where notnull(connectionId) and connectionId endswith "/managedApis/sql"
     | project id, name, resourceGroup, actionsJson
     | summarize v1ActionCount = count() by resourceGroup, logicAppName = name
     

   • Azure Resource Graph-Explorer-Skript zum Identifizieren von Logik-Apps mit V1-Triggern.

     resources
     | where subscriptionId == "<subscription-id>"
     | where type == "microsoft.logic/workflows"
     | extend propertiesJson=parse_json(properties)
     | extend triggersJson=propertiesJson["definition"]["triggers"]
     | mv-expand triggersJson
     | where notnull(triggersJson)
     | extend path=extract("\"path\":\"(.*?)\"", 1, tostring(triggersJson))
     | where notnull(path) and path startswith "/datasets/default/"
     | extend triggerConnectionName=extract("\"connection\":{\"name\":\"(.*?)\"}", 1, tostring(triggersJson))
     | where notnull(triggerConnectionName)
     | parse triggerConnectionName with "@parameters('$connections')['"parsedTriggerConnectionName"']['connectionId']"
     | extend tmpConnection = propertiesJson["parameters"]["$connections"]["value"][parsedTriggerConnectionName]
     | where notnull(tmpConnection)
     | extend connectionId=extract("\"id\":\"(.*?)\"", 1, tostring(tmpConnection))
     | where notnull(connectionId) and connectionId endswith "/managedApis/sql"
     | project id, name, resourceGroup, triggersJson
     | summarize v1TriggerCount = count() by resourceGroup, logicAppName = name
     

Migrieren zu V2-Vorgängen auf der UX

Migrieren von Logik-Apps und Power Automate-Automatisierung

1. Öffnen Sie den Logik-App- oder Power Automate-Fluss, der die V1-Aktion enthält.

2. Fügen Sie eine Aktion direkt vor oder nach der V1-Aktion hinzu, die Sie aktualisieren möchten.

   

3. Klicken Sie auf den SQL Server-Connector, und suchen Sie nach der V2-Entsprechung der zu migrierenden Aktion.

   

4. Wählen Sie die Verbindung aus, die für die V2-Aktion verwendet werden soll.

   Tipp

   V2-Aktionen unterstützen Microsoft Entra ID-Authentifizierungstypen. Logic Apps unterstützt auch Azure Logic Apps unterstützt die verwaltete Identitätsauthentifizierung bei V2-Aktionen.

   Weitere Informationen finden Sie im Abschnitt "Authentifizierung ".

5. Geben Sie den Servernamen ein.

   • Wenn Sie den Servernamen verwenden Windows Authentication oder SQL Server Authenticationverwenden, wählen Sie den Servernamen aus der Dropdownliste aus.

     

   • Wenn Sie den Authentifizierungstyp verwendenService principalManaged Identity, Microsoft Entra ID klicken Sie in der Dropdownliste auf "Benutzerdefinierten Wert eingeben", und geben Sie dann Ihren Servernamen ein.

     

6. Geben Sie Ihre Datenbank ein, indem Sie sie aus der Dropdownliste auswählen.

   

7. Geben Sie die restlichen Parameter ein, damit sie mit der V1-Aktion identisch sind.

8. Löschen Sie nach Abschluss der Konfiguration der V1-Aktion die V2-Aktion.

   

   Von Bedeutung

   Durch das Löschen der V1-Aktion werden alle dynamischen Inhalte von V1 gelöscht. Dynamische v2-Inhalte müssen erneut hinzugefügt werden.

Migrieren von Power Apps

1. Öffnen Sie die App, die aktualisiert werden muss.

2. Löschen Sie alle SQL-Datenquellen.

   Hinweis

   Formeln, die die gelöschten Datenquellen verwenden, zeigen einen Fehler an, dies wird erwartet und wird bei den nächsten Schritten behoben.

   

3. Öffnen Sie die Registerkarte "Anstehende Features" auf der Registerkarte "Einstellungen", und geben Sie im Suchfeld "SQL" ein. Das Feature "Erweiterten Microsoft SQL Server-Connector aktivieren" wird angezeigt.

   

4. Aktivieren Sie das Feature "Erweiterten Microsoft SQL Server-Connector aktivieren".

   Hinweis

   Dieses Feature ist standardmäßig für alle neuen Power Apps aktiviert.

   

5. Die Datenquelle wurde gelesen.

   

6. Überprüfen Sie das App-Verhalten, insbesondere in Tabellen, die DateTime-Datentypen behandeln.

7. Speichern Sie die App.

Migrieren von Vorgängen über die Codeansicht in Azure Logic Apps

Bei komplexeren Szenarien können Aktionen migriert werden, indem die Definition des Workflows aktualisiert wird.

1. Identifizieren Sie den Namen der Vorgänge (Trigger und/oder Aktionen), die in der Logik-App migriert werden müssen.

2. Öffnen Sie den Designer der zu ändernden Logik-App, und klicken Sie auf "Codeansicht".

   

3. Für jede Aktion, die migriert werden muss:

   1. Suchen der Aktions- oder Triggerpfadeigenschaft
   2. Ersetzen /datasets/default/ Sie in der Pfadeigenschaft durch /v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/.

4. Sobald alle Vorgänge aktualisiert wurden, klicken Sie auf "Designer".

   

5. Überprüfen Sie, ob alle Vorgänge erfolgreich migriert wurden.

   • Der Server- und Datenbankname sollte mit den Werten der Verbindung aufgefüllt werden.
   • Alle anderen Parameter sollten ebenfalls ausgefüllt werden.

   

6. Speichern und testen Sie die Logik-App.

Tipp

Nach der Migration von Aktionen zur V2-Version kann der Name und die Verbindung des Vorgangs aktualisiert werden.

Hier ist ein Beispiel für die Migration von Get rows [DEPRECATED].

1. Öffnen Sie "Codeansicht".

2. Suchen Sie die Aktion "Zeilen abrufen [VERALTET]".

   "actions": {
     "Get_rows_[DEPRECATED]": {
       "inputs": {
         "host": {
           "connection": {"name": "..."},
           "method": "get",
           "path": "/datasets/default/tables/.../items"
         },
         "runAfter": {},
         "type": "ApiConnection"
       }
     }
   }
   

3. Aktualisieren Sie das Datasetsegment des Pfads mit dem oben angegebenen Ersatz.

   "actions": {
     "Get_rows_[DEPRECATED]": {
       "inputs": {
         "host": {
           "connection": {"name": "..."},
           "method": "get",
           "path": "/v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/tables/.../items"
         },
         "runAfter": {},
         "type": "ApiConnection"
       }
     }
   }
   

4. Klicken Sie auf "Designer", um zur anfänglichen Ansicht zurückzukehren und zu überprüfen, ob die Aktion ordnungsgemäß ausgefüllt wurde.

Migrieren von Vorgängen durch Bearbeiten der Ablaufdefinition

1. Identifizieren Sie den Namen der Vorgänge (Trigger und/oder Aktionen), die in der Logik-App migriert werden müssen.

2. Exportieren Des Flusses als Paket (ZIP).

   

3. Extrahieren Sie die ZIP-Datei.

4. Öffnen Sie den Ordner, in dem ZIP extrahiert wurde.

5. Navigieren Sie zu Microsoft.Flow, und klicken Sie dann flowsauf die GUID mit dem Namen Ordner.

6. Öffnen Sie die definition.json Datei in einem Text-Editor.

   • Um die Lesbarkeit zu verbessern, formatieren Sie den JSON-Code.

7. Für jede Aktion, die migriert werden muss:

   1. Suchen der Aktion oder Triggereigenschaft

   2. Aktualisieren Sie inputs.host.operationId die Eigenschaft auf die V2-Entsprechung. Sie finden den Wert in der Dokumentation des Vorgangs.

      

   3. inputs.parameters Zu zwei Eigenschaften hinzufügen:

      • server mit Wert default
      • database mit Wert default

8. Speichern der definition.json Datei

9. Navigieren Sie zurück zu der Stelle, an der sich manifest.json und Microsoft.Flow befinden.

10. Wählen Sie sowohl Microsoft.Flow als auch manifest.jsonaus, und komprimieren Sie sie in eine ZIP-Datei.

    Von Bedeutung

    Stellen Sie sicher, dass die neue ZIP-Datei die gleiche Datei- und Ordnerstruktur wie die ursprüngliche ZIP-Datei aufweist.

    Der Ordner "Microsoft.Flow" und die Datei manifest.json müssen sich im Stammverzeichnis der neuen ZIP-Datei befinden. Wenn die gleiche Struktur nicht vorhanden ist, treten beim Hochladen des Pakets Fehler auf.

    

11. Navigieren Sie zu Ihren Flüssen in Power Automate.

12. Importieren Sie den aktualisierten Fluss, indem Sie das Paket importieren. Wählen Sie die neu erstellte ZIP-Datei aus, und laden Sie das Paket hoch.

    

13. Wählen Sie das Importsetup aus (importieren/erstellen Sie ein neues), und wählen Sie die Verbindungen aus, die vom Fluss verwendet werden.

14. Sobald der Import abgeschlossen ist, öffnen Sie den neuen/aktualisierten Fluss.

15. Überprüfen, ob die Aktionen aktualisiert wurden

• Der Server- und Datenbankname sollte mit den Werten der Verbindung aufgefüllt werden.

• Alle anderen Parameter sollten ebenfalls ausgefüllt werden.

  

Tipp

Nach der Migration von Aktionen zur V2-Version kann der Name und die Verbindung des Vorgangs auf der UX aktualisiert werden.

Hier ist ein Beispiel für die Migration einer SQL-Abfrage [DEPRECATED].

1. Öffnen Sie "Codeansicht".

2. Suchen Sie die Aktion "SQL-Abfrage ausführen [VERALTET]".

   "actions": {
     "Execute_a_SQL_query_[DEPRECATED]": {
       // ...
       "inputs": {
         "host": {
           // ...
           "operationId": "ExecutePassThroughNativeQuery"
         },
         "parameters": {
           "query/query": "SELECT * from [dbo].[SampleTable] WHERE AnyId = 42",
         },
         // ..
       }
     }
   }
   

3. Aktualisieren Sie die Vorgangs-ID mit der V2-Vorgangs-ID, und fügen Sie dann die Server- und Datenbankparameter mit dem default Wert hinzu, wie oben beschrieben.

   "actions": {
     "Execute_a_SQL_query_[DEPRECATED]": {
       // ...
       "inputs": {
         "host": {
           // ...
           "operationId": "ExecutePassThroughNativeQuery_V2"
         },
         "parameters": {
           "server": "default",
           "database": "default",
           "query/query": "SELECT * from [dbo].[SampleTable] WHERE AnyId = 42",
         },
         // ..
       }
     }
   }
   
   

Von Bedeutung

Microsoft Entra ID Integrated (Azure Commercial) -Verbindungen sind standardmäßig in US Government(GCC) -Umgebungen deaktiviert. Um diese Arten von Verbindungen zu aktivieren, muss die Einstellung "Mit Azure Commercial verbinden " im Power Platform Admin Center von einem Mandantenadministrator aktiviert werden.

Wenn Sie diese Einstellung aktivieren, können Verbindungen zu Ressourcen in Azure Commercial verwendet werden, die Daten außerhalb der Compliancegrenze von Power Platform US Government betreiben und senden. Dies wird speziell verwendet, um den Zugriff auf kommerzielle Ressourcen aus GCC-Cloudversionen von Power Platform Connectors zu ermöglichen.

Microsoft Entra ID Integrated (Azure Commercial) ist der einzige Authentifizierungstyp, der von US Government (GCC)- Umgebungen zu Azure Commercial-Ressourcen funktioniert.

Standardmäßig deaktivierte kommerzielle Azure-Authentifizierung:

Die Einstellung "Mit Azure Commercial verbinden " im Power Platform Admin Center:

Eine Verbindung wird erstellt

Der Connector unterstützt die folgenden Authentifizierungstypen:

Clientzertifikatauthentifizierung	Bereitstellen von Microsoft Entra ID-Anmeldeinformationen mit PFX-Zertifikat und Kennwort	Alle Regionen	Freigabefähig
Microsoft Entra ID-integriert	Verwenden Sie Die Microsoft Entra-ID, um auf Ihre SQL-Datenbank zuzugreifen.	Alle Regionen mit Ausnahme der US Government (GCC)	Nicht teilbar
Microsoft Entra ID Integrated (Azure Commercial)	Verwenden Sie die Microsoft Entra-ID, um auf Ihre SQL-Datenbank in Azure Commercial zuzugreifen.	Nur US-Regierung (GCC)	Nicht teilbar
Microsoft Entra ID Integrated (Azure Government)	Verwenden Sie die Microsoft Entra-ID, um auf Ihre SQL-Datenbank in Azure Government zuzugreifen.	Nur US-Regierung (GCC)	Nicht teilbar
Dienstprinzipal (Microsoft Entra ID-Anwendung)	Verwenden Sie die Microsoft Entra ID-Anwendung, um auf Ihre SQL-Datenbank zuzugreifen.	Alle Regionen	Freigabefähig
SQL Server-Authentifizierung	Verwenden Sie einen Kontonamen und ein Kennwort, um auf Ihre SQL-Datenbank zuzugreifen.	Alle Regionen	Freigabefähig
Windows-Authentifizierung	Verwenden Sie einen lokalen Microsoft Entra ID-Kontonamen und ein Kennwort, um auf Ihre SQL-Datenbank zuzugreifen.	Alle Regionen	Freigabefähig
Windows-Authentifizierung (nicht freigegeben)	Verwenden Sie einen lokalen Microsoft Entra ID-Kontonamen und ein Kennwort, um auf Ihre SQL-Datenbank zuzugreifen.	Alle Regionen	Nicht teilbar
Standard [VERALTET]	Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt.	Alle Regionen	Nicht teilbar

Clientzertifikatauthentifizierung

Authentifizierungs-ID: certOauth

Anwendbar: Alle Regionen

Bereitstellen von Microsoft Entra ID-Anmeldeinformationen mit PFX-Zertifikat und Kennwort

Dies ist eine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird auch die Verbindung freigegeben. Weitere Informationen finden Sie in der Übersicht über Connectors für Canvas-Apps – Power Apps | Microsoft-Dokumente

Name	Typ	Description	Erforderlich
Tenant	Schnur		Richtig
Kunden-ID	Schnur	Die Client-ID der Microsoft Entra-ID-Anwendung
Geheimer Clientzertifikatschlüssel	Client-Zertifikat	Der von dieser Anwendung zulässige geheime Clientzertifikatschlüssel	Richtig

Microsoft Entra ID integriert

Authentifizierungs-ID: oauth

Anwendbar: Alle Regionen außer US Government (GCC)

Verwenden Sie Die Microsoft Entra-ID, um auf Ihre SQL-Datenbank zuzugreifen.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Microsoft Entra ID Integrated (Azure Commercial)

Auth-ID: oauthCom

Anwendbar: Nur US Government (GCC)

Verwenden Sie die Microsoft Entra-ID, um auf Ihre SQL-Datenbank in Azure Commercial zuzugreifen.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Microsoft Entra ID Integrated (Azure Government)

Authentifizierungs-ID: oauth

Anwendbar: Nur US Government (GCC)

Verwenden Sie die Microsoft Entra-ID, um auf Ihre SQL-Datenbank in Azure Government zuzugreifen.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Dienstprinzipal (Microsoft Entra ID-Anwendung)

Authentifizierungs-ID: oauthSP

Anwendbar: Alle Regionen

Verwenden Sie die Microsoft Entra ID-Anwendung, um auf Ihre SQL-Datenbank zuzugreifen.

Dies ist eine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird auch die Verbindung freigegeben. Weitere Informationen finden Sie in der Übersicht über Connectors für Canvas-Apps – Power Apps | Microsoft-Dokumente

Name	Typ	Description	Erforderlich
Tenant	Schnur		Richtig
Kunden-ID	Schnur		Richtig
Geheimer Clientschlüssel	securestring		Richtig

SQL Server-Authentifizierung

Authentifizierungs-ID: sqlAuthentication

Anwendbar: Alle Regionen

Verwenden Sie einen Kontonamen und ein Kennwort, um auf Ihre SQL-Datenbank zuzugreifen.

Dies ist eine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird auch die Verbindung freigegeben. Weitere Informationen finden Sie in der Übersicht über Connectors für Canvas-Apps – Power Apps | Microsoft-Dokumente

Name	Typ	Description	Erforderlich
SQL-Servername	Schnur	Geben Sie den Namen des SQL-Servers an (server[:p ort])	Richtig
SQL-Datenbankname	Schnur	SQL-Datenbankname	Richtig
Nutzername	securestring	Anmeldeinformationen für Benutzernamen	Richtig
Kennwort	securestring	Kennwortanmeldeinformationen	Richtig
Gateway	gatewaySetting	Lokales Gateway (weitere Details finden Sie unter https://docs.microsoft.com/data-integration/gateway

Windows-Authentifizierung

Authentifizierungs-ID: windowsAuthentication

Anwendbar: Alle Regionen

Verwenden Sie einen lokalen Microsoft Entra ID-Kontonamen und ein Kennwort, um auf Ihre SQL-Datenbank zuzugreifen.

Dies ist eine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird auch die Verbindung freigegeben. Weitere Informationen finden Sie in der Übersicht über Connectors für Canvas-Apps – Power Apps | Microsoft-Dokumente

Name	Typ	Description	Erforderlich
SQL-Servername	Schnur	Geben Sie den Namen des SQL-Servers an (server[:p ort])	Richtig
SQL-Datenbankname	Schnur	SQL-Datenbankname	Richtig
Nutzername	securestring	Anmeldeinformationen für Benutzernamen	Richtig
Kennwort	securestring	Kennwortanmeldeinformationen	Richtig
Gateway	gatewaySetting	Lokales Gateway (weitere Details finden Sie unter https://docs.microsoft.com/data-integration/gateway	Richtig

Windows-Authentifizierung (nicht freigegeben)

Authentifizierungs-ID: windowsAuthenticationNonShared

Anwendbar: Alle Regionen

Verwenden Sie einen lokalen Microsoft Entra ID-Kontonamen und ein Kennwort, um auf Ihre SQL-Datenbank zuzugreifen.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name	Typ	Description	Erforderlich
Nutzername	securestring	Anmeldeinformationen für Benutzernamen	Richtig
Kennwort	securestring	Kennwortanmeldeinformationen	Richtig
Gateway	gatewaySetting	Lokales Gateway (weitere Details finden Sie unter https://docs.microsoft.com/data-integration/gateway	Richtig

Standard [VERALTET]

Anwendbar: Alle Regionen

Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name	Typ	Description	Erforderlich
SQL-Servername	Schnur	SQL-Servername	Richtig
SQL-Datenbankname	Schnur	SQL-Datenbankname	Richtig
Authentifizierungstyp	Schnur	Authentifizierungstyp zum Herstellen einer Verbindung mit Ihrer Datenbank
Nutzername	securestring	Anmeldeinformationen für Benutzernamen	Richtig
Kennwort	securestring	Kennwortanmeldeinformationen	Richtig
Gateway	gatewaySetting	Lokales Gateway (weitere Details finden Sie unter https://docs.microsoft.com/data-integration/gateway

Drosselungsgrenzwerte

Name	Aufrufe	Verlängerungszeitraum
API-Aufrufe pro Verbindung	100	10 Sekunden

Aktionen

Abrufen von Tabellen (V2)	Dieser Vorgang ruft Tabellen aus einer Datenbank ab.
Abrufen von Zeilen (V2)	Dieser Vorgang ruft Zeilen aus einer Tabelle ab.
Abrufen von Zeilen [VERALTET]	Diese Aktion ist veraltet. Verwenden Sie stattdessen Get-Zeilen (V2 ). Dieser Vorgang ruft Zeilen aus einer Tabelle ab.
Ausführen einer gespeicherten Prozedur	Dieser Vorgang führt eine gespeicherte Prozedur aus.
Ausführen einer SQL-Abfrage (V2)	Ausführen einer SQL-Abfrage (V2)
Ausführen einer SQL-Abfrage [VERALTET]	Diese Aktion ist veraltet. Verwenden Sie stattdessen eine SQL-Abfrage (V2). Ausführen einer SQL-Abfrage
Ausgeführte gespeicherte Prozedur (V2)	Dieser Vorgang führt eine gespeicherte Prozedur aus.
Listet Tabellen auf, die von der Verbindung verfügbar gemacht werden [VERALTET]	Diese Aktion ist veraltet. Verwenden Sie stattdessen Get-Tabellen (V2 ). Listet Tabellen auf, die von der Verbindung verfügbar gemacht werden
Transformieren von Daten mithilfe von Power Query	Transformieren von Daten mithilfe von Power Query. Hinweis: Dieser Vorgang funktioniert nicht beim Herstellen einer Verbindung mit sql Microsoft Entra ID.
Zeile abrufen (V2)	Dieser Vorgang ruft eine Zeile aus einer Tabelle ab.
Zeile abrufen [VERALTET]	Diese Aktion ist veraltet. Verwenden Sie stattdessen die Zeile "Get" (V2 ). Dieser Vorgang ruft eine Zeile aus einer Tabelle ab.
Zeile aktualisieren (V2)	Dieser Vorgang aktualisiert eine vorhandene Zeile in einer Tabelle.
Zeile aktualisieren [VERALTET]	Diese Aktion ist veraltet. Verwenden Sie stattdessen die Zeile "Update" (V2 ). Dieser Vorgang aktualisiert eine vorhandene Zeile in einer Tabelle.
Zeile einfügen (V2)	Dieser Vorgang fügt eine neue Zeile in eine Tabelle ein.
Zeile einfügen [VERALTET]	Diese Aktion ist veraltet. Verwenden Sie stattdessen die Zeile "Einfügen" (V2 ). Dieser Vorgang fügt eine neue Zeile in eine Tabelle ein.
Zeile löschen (V2)	Dieser Vorgang löscht eine Zeile aus einer Tabelle.
Zeile löschen [VERALTET]	Diese Aktion ist veraltet. Verwenden Sie stattdessen die Zeile "Löschen" (V2 ). Dieser Vorgang löscht eine Zeile aus einer Tabelle.

Abrufen von Tabellen (V2)

Vorgangs-ID:

GetTables_V2

Dieser Vorgang ruft Tabellen aus einer Datenbank ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Servername	server	True	string	Name des SQL-Servers
Datenbankname	database	True	string	Datenbankname

Gibt zurück

Stellt eine Liste von Tabellen dar.

Body

TablesList

Abrufen von Zeilen (V2)

Vorgangs-ID:

GetItems_V2

Dieser Vorgang ruft Zeilen aus einer Tabelle ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Servername	server	True	string	Name des SQL-Servers
Datenbankname	database	True	string	Datenbankname
Tabellenname	table	True	string	Name der SQL-Tabelle
Aggregationstransformation	$apply		string	Eine Sequenz aus OData-Aggregationstransformationen
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage, um die zurückgegebenen Einträge einzuschränken (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Bestellung nach	$orderby		string	Eine ODATA orderBy-Abfrage zum Angeben der Reihenfolge der Einträge.
Anzahl überspringen	$skip		integer	Die Anzahl der zu überspringenden Einträge (Standard = 0).
Höchste Anzahl	$top		integer	Gesamtzahl der abzurufenden Einträge (Standard = alle).
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Abrufen von Zeilen [VERALTET]

Vorgangs-ID:

GetItems

Diese Aktion ist veraltet. Verwenden Sie stattdessen Get-Zeilen (V2 ).

Dieser Vorgang ruft Zeilen aus einer Tabelle ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Tabellenname	table	True	string	Name der SQL-Tabelle
Aggregationstransformation	$apply		string	Eine Sequenz aus OData-Aggregationstransformationen
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage, um die zurückgegebenen Einträge einzuschränken (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Bestellung nach	$orderby		string	Eine ODATA orderBy-Abfrage zum Angeben der Reihenfolge der Einträge.
Anzahl überspringen	$skip		integer	Die Anzahl der zu überspringenden Einträge (Standard = 0).
Höchste Anzahl	$top		integer	Gesamtzahl der abzurufenden Einträge (Standard = alle).
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Ausführen einer gespeicherten Prozedur

Vorgangs-ID:

ExecuteProcedure

Dieser Vorgang führt eine gespeicherte Prozedur aus.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Prozedurname	procedure	True	string	Name der gespeicherten Prozedur
Parameterliste	parameters	True	dynamic	Eingabeparameter für die gespeicherte Prozedur

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Ausführen einer SQL-Abfrage (V2)

Vorgangs-ID:

ExecutePassThroughNativeQuery_V2

Ausführen einer SQL-Abfrage (V2)

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Servername	server	True	string	Name des SQL-Servers
Datenbankname	database	True	string	Datenbankname
Query	query	True	dynamic	Abfragetext

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Ausführen einer SQL-Abfrage [VERALTET]

Vorgangs-ID:

ExecutePassThroughNativeQuery

Diese Aktion ist veraltet. Verwenden Sie stattdessen eine SQL-Abfrage (V2).

Ausführen einer SQL-Abfrage

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Query	query	True	dynamic	Abfragetext

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Ausgeführte gespeicherte Prozedur (V2)

Vorgangs-ID:

ExecuteProcedure_V2

Dieser Vorgang führt eine gespeicherte Prozedur aus.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Servername	server	True	string	Name des SQL-Servers
Datenbankname	database	True	string	Datenbankname
Prozedurname	procedure	True	string	Name der gespeicherten Prozedur
Parameterliste	parameters	True	dynamic	Eingabeparameter für die gespeicherte Prozedur

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Listet Tabellen auf, die von der Verbindung verfügbar gemacht werden [VERALTET]

Vorgangs-ID:

GetTables

Diese Aktion ist veraltet. Verwenden Sie stattdessen Get-Tabellen (V2 ).

Listet Tabellen auf, die von der Verbindung verfügbar gemacht werden

Gibt zurück

Stellt eine Liste von Tabellen dar.

Body

TablesList

Transformieren von Daten mithilfe von Power Query

Vorgangs-ID:

SqlExecutePassThroughPowerQuery

Transformieren von Daten mithilfe von Power Query. Hinweis: Dieser Vorgang funktioniert nicht beim Herstellen einer Verbindung mit sql Microsoft Entra ID.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Anfrage	query		mquery	Abfragetext

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Zeile abrufen (V2)

Vorgangs-ID:

GetItem_V2

Dieser Vorgang ruft eine Zeile aus einer Tabelle ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Servername	server	True	string	Name des SQL-Servers
Datenbankname	database	True	string	Datenbankname
Tabellenname	table	True	string	Name der SQL-Tabelle
Zeilen-ID	id	True	string	Eindeutiger Bezeichner der abzurufenden Zeile

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Zeile abrufen [VERALTET]

Vorgangs-ID:

GetItem

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Zeile "Get" (V2 ).

Dieser Vorgang ruft eine Zeile aus einer Tabelle ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Tabellenname	table	True	string	Name der SQL-Tabelle
Zeilen-ID	id	True	string	Eindeutiger Bezeichner der abzurufenden Zeile

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Zeile aktualisieren (V2)

Vorgangs-ID:

PatchItem_V2

Dieser Vorgang aktualisiert eine vorhandene Zeile in einer Tabelle.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Servername	server	True	string	Name des SQL-Servers
Datenbankname	database	True	string	Datenbankname
Tabellenname	table	True	string	Name der Tabelle
Zeilen-ID	id	True	string	Eindeutiger Bezeichner der zu aktualisierenden Zeile
Row	item	True	dynamic	Zeile mit aktualisierten Werten

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Zeile aktualisieren [VERALTET]

Vorgangs-ID:

PatchItem

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Zeile "Update" (V2 ).

Dieser Vorgang aktualisiert eine vorhandene Zeile in einer Tabelle.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Tabellenname	table	True	string	Name der Tabelle
Zeilen-ID	id	True	string	Eindeutiger Bezeichner der zu aktualisierenden Zeile
Row	item	True	dynamic	Zeile mit aktualisierten Werten

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Zeile einfügen (V2)

Vorgangs-ID:

PostItem_V2

Dieser Vorgang fügt eine neue Zeile in eine Tabelle ein.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Servername	server	True	string	Name des SQL-Servers
Datenbankname	database	True	string	Datenbankname
Tabellenname	table	True	string	Name der Tabelle
Row	item	True	dynamic	Zeile, die in die angegebene Tabelle eingefügt werden soll

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Zeile einfügen [VERALTET]

Vorgangs-ID:

PostItem

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Zeile "Einfügen" (V2 ).

Dieser Vorgang fügt eine neue Zeile in eine Tabelle ein.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Tabellenname	table	True	string	Name der Tabelle
Row	item	True	dynamic	Zeile, die in die angegebene Tabelle eingefügt werden soll

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Zeile löschen (V2)

Vorgangs-ID:

DeleteItem_V2

Dieser Vorgang löscht eine Zeile aus einer Tabelle.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Servername	server	True	string	Name des SQL-Servers
Datenbankname	database	True	string	Datenbankname
Tabellenname	table	True	string	Name der Tabelle
Zeilen-ID	id	True	string	Eindeutiger Bezeichner der zu löschenden Zeile

Zeile löschen [VERALTET]

Vorgangs-ID:

DeleteItem

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Zeile "Löschen" (V2 ).

Dieser Vorgang löscht eine Zeile aus einer Tabelle.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Tabellenname	table	True	string	Name der Tabelle
Zeilen-ID	id	True	string	Eindeutiger Bezeichner der zu löschenden Zeile

Auslöser

Beim Erstellen eines Elements (V2)	Löst einen Fluss aus, wenn ein Element in SQL erstellt wird.
Wenn ein Element erstellt wird [VERALTET]	Diese Aktion ist veraltet. Verwenden Sie stattdessen die Verwendung, wenn ein Element erstellt wird (V2 ). Löst einen Fluss aus, wenn ein Element in SQL erstellt wird.
Wenn ein Element geändert wird (V2)	Löst einen Fluss aus, wenn ein Element in SQL geändert/eingefügt wird.
Wenn ein Element geändert wird [VERALTET]	Diese Aktion ist veraltet. Verwenden Sie stattdessen die Verwendung, wenn ein Element geändert wird (V2 ). Löst einen Fluss aus, wenn ein Element in SQL geändert/eingefügt wird.

Beim Erstellen eines Elements (V2)

Vorgangs-ID:

GetOnNewItems_V2

Löst einen Fluss aus, wenn ein Element in SQL erstellt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Servername	server	True	string	Name des SQL-Servers
Datenbankname	database	True	string	Datenbankname
Tabellenname	table	True	string	Name der SQL-Tabelle
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage, um die zurückgegebenen Einträge einzuschränken (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Höchste Anzahl	$top		integer	Gesamtzahl der abzurufenden Einträge (Standard = alle).
Bestellung nach	$orderby		string	Eine ODATA orderBy-Abfrage zum Angeben der Reihenfolge der Einträge.
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Wenn ein Element erstellt wird [VERALTET]

Vorgangs-ID:

GetOnNewItems

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Verwendung, wenn ein Element erstellt wird (V2 ).

Löst einen Fluss aus, wenn ein Element in SQL erstellt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Tabellenname	table	True	string	Name der SQL-Tabelle
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage, um die zurückgegebenen Einträge einzuschränken (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Höchste Anzahl	$top		integer	Gesamtzahl der abzurufenden Einträge (Standard = alle).
Bestellung nach	$orderby		string	Eine ODATA orderBy-Abfrage zum Angeben der Reihenfolge der Einträge.
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Wenn ein Element geändert wird (V2)

Vorgangs-ID:

GetOnUpdatedItems_V2

Löst einen Fluss aus, wenn ein Element in SQL geändert/eingefügt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Servername	server	True	string	Name des SQL-Servers
Datenbankname	database	True	string	Datenbankname
Tabellenname	table	True	string	Name der SQL-Tabelle
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage, um die zurückgegebenen Einträge einzuschränken (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Höchste Anzahl	$top		integer	Gesamtzahl der abzurufenden Einträge (Standard = alle).
Bestellung nach	$orderby		string	Eine ODATA orderBy-Abfrage zum Angeben der Reihenfolge der Einträge.
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Wenn ein Element geändert wird [VERALTET]

Vorgangs-ID:

GetOnUpdatedItems

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Verwendung, wenn ein Element geändert wird (V2 ).

Löst einen Fluss aus, wenn ein Element in SQL geändert/eingefügt wird.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Tabellenname	table	True	string	Name der SQL-Tabelle
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage, um die zurückgegebenen Einträge einzuschränken (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Höchste Anzahl	$top		integer	Gesamtzahl der abzurufenden Einträge (Standard = alle).
Bestellung nach	$orderby		string	Eine ODATA orderBy-Abfrage zum Angeben der Reihenfolge der Einträge.
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Definitionen

Table

Stellt eine Tabelle dar.

Name	Pfad	Typ	Beschreibung
Name	Name	string	Der Name der Tabelle. Der Name wird zur Laufzeit verwendet.
Anzeigename	DisplayName	string	Der Anzeigename der Tabelle.
DynamicProperties	DynamicProperties	object	Zusätzliche Tabelleneigenschaften, die vom Connector für die Clients bereitgestellt werden.

TablesList

Stellt eine Liste von Tabellen dar.

Name	Pfad	Typ	Beschreibung
value	value	array of Table	Liste der Tabellen