SQL Server

Microsoft SQL Server to system zarządzania relacyjnymi bazami danych opracowany przez firmę Microsoft. Nawiązywanie połączenia z programem SQL Server w celu zarządzania danymi. Możesz wykonywać różne akcje, takie jak tworzenie, aktualizowanie, pobieranie i usuwanie wierszy w tabeli.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa	Class	Regions
Copilot Studio	Premium	Wszystkie regiony usługi Power Automate
Logic Apps	Standard	Wszystkie regiony usługi Logic Apps
Power Apps	Premium	Wszystkie regiony usługi Power Apps
Power Automate	Premium	Wszystkie regiony usługi Power Automate

Metadane łącznika
Publisher	Microsoft

Szczegółowe informacje o konektorze

W tym artykule opisano operacje łącznika zarządzanego programu SQL Server, który jest dostępny dla usług Azure Logic Apps, Power Automate i Power Apps. Wbudowany łącznik programu SQL Server jest dostępny tylko dla standardowych przepływów pracy aplikacji logiki w usłudze Azure Logic Apps.

• Aby uzyskać więcej informacji na temat tego łącznika w usłudze Power Apps, zobacz Connect to SQL Server from Power Apps (Nawiązywanie połączenia z programem SQL Server z poziomu usługi Power Apps).
• Aby uzyskać więcej informacji na temat wbudowanego łącznika programu SQL Server i łącznika zarządzanego w usłudze Azure Logic Apps, zobacz Łączenie się z bazami danych SQL z przepływów pracy w usłudze Azure Logic Apps.

Authentication

Jeśli chcesz utworzyć połączenia innej niż Microsoft Entra ID (Microsoft Entra ID), użyj opcji uwierzytelniania parametrów połączenia. Upewnij się, że w połączeniu podaj te same wartości nazwy serwera i nazwy bazy danych , jak zdefiniowano w połączeniu.

Uwierzytelnianie za pomocą Microsoft Entra ID

Znane ograniczenia dotyczące uwierzytelniania identyfikatora Entra firmy Microsoft

Ze względu na bieżące ograniczenia potoku uwierzytelniania użytkownicy-goście identyfikatora entra firmy Microsoft nie są obsługiwani w przypadku połączeń microsoft Entra ID z programem SQL Server. Aby rozwiązać ten problem, zamiast tego użyj uwierzytelniania programu SQL Server lub uwierzytelniania systemu Windows.

Włączanie uwierzytelniania identyfikatora Entra firmy Microsoft dla programu SQL Server

1. Skonfiguruj i aprowizuj swoje konto jako element członkowski microsoft Entra ID (Microsoft Entra ID). Aby uzyskać więcej informacji, zobacz Konfigurowanie uwierzytelniania identyfikatora entra firmy Microsoft i zarządzanie nim za pomocą usługi Azure SQL.

2. Na serwerze SQL skonfiguruj administratora identyfikatora entra firmy Microsoft.

   1. W witrynie Azure Portal przejdź do serwera SQL, na którym chcesz włączyć uwierzytelnianie identyfikatora Entra firmy Microsoft.
   2. W menu zasobów programu SQL Server w obszarze Ustawienia wybierz pozycję Microsoft Entra ID.
   3. Na pasku narzędzi okienka Microsoft Entra ID wybierz pozycję Ustaw administratora.
   4. Znajdź i wybierz konto użytkownika Microsoft Entra ID w bieżącej dzierżawie, aby utworzyć je jako administrator serwera. Zapisz zmiany.

3. W dzierżawie identyfikatora Entra firmy Microsoft utwórz i zarejestruj aplikację Microsoft Entra ID w celu uzyskania dostępu do bazy danych SQL. Aby uzyskać więcej informacji, zobacz SQL Server — Konfigurowanie uwierzytelniania identyfikatora entra firmy Microsoft.

   1. W witrynie Azure Portal przejdź do dzierżawy microsoft Entra ID, w której chcesz utworzyć aplikację Microsoft Entra ID.

   2. W menu dzierżawy w obszarze Zarządzanie wybierz pozycję Rejestracje> aplikacjiNowa rejestracja.

   3. W okienku Rejestrowanie aplikacji podaj nazwę aplikacji. Zapamiętaj tę nazwę, aby później utworzyć użytkownika i udzielić dostępu roli do bazy danych SQL.

   4. Po zakończeniu wybierz pozycję Zarejestruj, co spowoduje utworzenie aplikacji Microsoft Entra ID.

   5. W okienku Rejestracje aplikacji wybierz nową aplikację Microsoft Entra ID. W menu aplikacji wybierz pozycję Certyfikaty i wpisy tajne>Nowy klucz tajny klienta.

   6. Podaj opis wpisu tajnego i wybierz wygaśnięcie.

4. Zaloguj się do serwera SQL i bazy danych przy użyciu poświadczeń konta użytkownika Microsoft Entra ID skonfigurowanego jako administrator serwera.

5. W bazie danych SQL utwórz zawartego użytkownika reprezentującego aplikację Microsoft Entra ID. Ten krok wymaga programu Microsoft SQL Server Management Studio (SSMS).

   Poniższe kroki umożliwiają przypisanie ról db_datareader i db_datawriter do aplikacji Microsoft Entra ID o nazwie example-Azure-AD-application-name. Po uruchomieniu określonych poleceń pamiętaj, aby zastąpić example-Azure-AD-application-name ciąg nazwą aplikacji Microsoft Entra ID i przypisać wymagane role do Twoich potrzeb.

   1. Uruchom program SSMS i połącz się z serwerem SQL, do którego będzie uzyskiwać dostęp aplikacja Microsoft Entra ID.

   2. W obszarze Uwierzytelnianie użyj usługi Active Directory — uniwersalnej z obsługą uwierzytelniania wieloskładnikowego i kontem Microsoft Entra ID skonfigurowanym jako administrator serwera.

   3. W Eksploratorze obiektów rozwiń folder Bazy danych .

   4. Znajdź bazę danych, otwórz menu skrótów bazy danych i wybierz pozycję Nowe zapytanie.

   5. W oknie zapytania wykonaj następujące polecenie, aby połączyć aplikację Microsoft Entra ID z nowym użytkownikiem w bazie danych:

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

   6. Wyczyść okno zapytania. Następnie uruchom następujące polecenie, aby przypisać db_datareader rolę do aplikacji Microsoft Entra ID:

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

   7. Powtórz poprzedni krok, aby przypisać db_datawriter rolę do aplikacji Microsoft Entra ID:

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

Uwierzytelnianie tożsamości zarządzanej

Obecnie tylko usługa Azure Logic Apps obsługuje uwierzytelnianie tożsamości zarządzanej dla łącznika programu SQL Server.

Uwierzytelnianie głównego elementu usługi

Konfigurowanie tożsamości zarządzanej w aplikacji logiki

1. W witrynie Azure Portal przejdź do zasobu aplikacji logiki.

2. Włącz tożsamość przypisaną przez system lub tożsamość przypisaną przez użytkownika. Jeśli nie masz tożsamości przypisanej przez użytkownika, musisz najpierw utworzyć tożsamość. Aby uzyskać więcej informacji, zobacz Uwierzytelnianie dostępu do zasobów platformy Azure za pomocą tożsamości zarządzanych w usłudze Azure Logic Apps.

3. Jeśli wybrano tożsamość przypisaną przez użytkownika, upewnij się, że dodano tożsamość do zasobu aplikacji logiki.

   1. W witrynie Azure Portal przejdź do zasobu aplikacji logiki, w którym chcesz użyć tożsamości zarządzanej.
   2. W menu nawigacji aplikacji logiki w obszarze Ustawienia wybierz pozycję Tożsamość.
   3. Na karcie Przypisane użytkownikowi wybierz pozycję Dodaj.
   4. Wybierz tożsamość zarządzaną do użycia, a następnie wybierz pozycję Dodaj.

Konfigurowanie programu SQL Server na potrzeby uwierzytelniania tożsamości zarządzanej

1. Na serwerze SQL skonfiguruj administratora identyfikatora entra firmy Microsoft.

   1. W witrynie Azure Portal przejdź do serwera SQL, na którym chcesz włączyć uwierzytelnianie identyfikatora Entra firmy Microsoft.
   2. W menu zasobów programu SQL Server w obszarze Ustawienia wybierz pozycję Microsoft Entra ID.
   3. Na pasku narzędzi okienka Microsoft Entra ID wybierz pozycję Ustaw administratora.
   4. Znajdź i wybierz konto użytkownika Microsoft Entra ID w bieżącej dzierżawie, aby utworzyć je jako administrator serwera. Zapisz zmiany.

2. W bazie danych SQL utwórz zawartego użytkownika reprezentującego tożsamość zarządzaną. Ten krok wymaga programu Microsoft SQL Server Management Studio (SSMS).

   Poniższe kroki umożliwiają przypisanie roli db_datareader do tożsamości zarządzanej o nazwie example-managed-identity-name. Po uruchomieniu określonych poleceń pamiętaj, aby zastąpić example-managed-identity-name ciąg nazwą tożsamości zarządzanej i przypisać odpowiednią rolę dla Twoich potrzeb. Na przykład db_datareader nie można wykonywać operacji zapisu.

   1. Uruchom program SSMS i połącz się z serwerem SQL, do którego będzie uzyskiwana tożsamość zarządzana.

   2. W obszarze Uwierzytelnianie użyj usługi Active Directory — uniwersalnej z obsługą uwierzytelniania wieloskładnikowego i kontem Microsoft Entra ID skonfigurowanym jako administrator serwera.

   3. W Eksploratorze obiektów rozwiń folder Bazy danych .

   4. Znajdź bazę danych, otwórz menu skrótów bazy danych i wybierz pozycję Nowe zapytanie.

   5. W oknie zapytania wykonaj następujące polecenie, aby połączyć tożsamość zarządzaną z nowym użytkownikiem w bazie danych:

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

   6. Wyczyść okno zapytania. Następnie uruchom następujące polecenie, aby przypisać rolę do tożsamości zarządzania:

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

      Uwaga / Notatka

      Jeśli przypiszesz role do tożsamości zarządzanej na poziomie bazy danych, tożsamość nie będzie miała wymaganych zakresów do wyświetlenia listy wszystkich baz danych. Po wybraniu z listy Nazwa bazy danych w wyzwalaczu LUB akcji SQL zostanie wyświetlony błąd podobny do następującego przykładu:

      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
      

      Aby rozwiązać ten problem, dostępne są następujące opcje:

      • Przypisz rolę na poziomie serwera, która może wyświetlić listę wszystkich baz danych do tożsamości zarządzanej.
      • W wyzwalaczu LUB akcji SQL wprowadź nazwę bazy danych przy użyciu opcji Wprowadź wartość niestandardową .

Aby uzyskać więcej informacji, zapoznaj się z następującą dokumentacją:

• Uwierzytelnianie dostępu do zasobów platformy Azure przy użyciu tożsamości zarządzanych w usłudze Azure Logic Apps
• Samouczek: używanie przypisanej przez system tożsamości zarządzanej maszyny wirtualnej z systemem Windows do uzyskiwania dostępu do usługi Azure SQL
• Konfigurowanie uwierzytelniania identyfikatora entra firmy Microsoft i zarządzanie nim za pomocą usługi Azure SQL
• Role na poziomie bazy danych
• Role na poziomie serwera

Obsługa sieci wirtualnej

Gdy łącznik jest używany w środowisku Power Platform połączonym z siecią wirtualną, obowiązują ograniczenia:

• Następujące akcje są jedynymi obsługiwanymi akcjami:

  • Usuń wiersz (wersja 2)
  • Wykonywanie zapytania SQL (wersja 2)
  • Pobieranie wiersza (wersja 2)
  • Pobieranie wierszy (wersja 2)
  • Pobieranie tabel (wersja 2)
  • Wstaw wiersz (wersja 2)
  • Aktualizuj wiersz (wersja 2)
  • Wykonywanie procedury składowanej (wersja 2)

• Każda akcja spoza tej listy zwróci błąd "403 Brak autoryzacji"

• Lokalna brama danych nie jest obsługiwana

• W przypadku korzystania ze zintegrowanego uwierzytelniania microsoft Entra ID wpisz nazwę bazy danych ręcznie jako wartość niestandardową

Znane problemy i ograniczenia dotyczące akcji

Krótki opis	Operations	Długi opis
Pobieranie wyników deterministycznych w danych wyjściowych akcji	Pobieranie wierszy (wersja 2)	Użycie parametru Order By jest zalecane w celu uzyskania wyników deterministycznych w danych wyjściowych akcji. Jeśli Order By nie zostanie określony, klucze podstawowe lub unikatowe klucze są domyślnie używane przez program SQL Server. Wyniki niedeterministyczne mogą powodować problemy, takie jak duplikowanie rekordów w danych wyjściowych akcji po włączeniu stronicowania. Widoki SQL nie obsługują klucza podstawowego, co jest ograniczeniem samego programu SQL Server.
Wykonywanie ograniczonej obsługi zapytań SQL	Wykonywanie zapytania SQL (wersja 2)	Nieobsługiwane w przypadku lokalnego programu SQL Server.
Ogólne wymagania dotyczące operacji CRUD	Pobieranie wiersza (wersja 2) Pobieranie wierszy (wersja 2) Aktualizuj wiersz (wersja 2) Usuń wiersz (wersja 2)	Wartości ciągów zostaną przycięte w przypadku użycia wystąpienia usługi Azure SQL. W związku z tym puste ciągi zostaną przekonwertowane na puste ciągi. W przypadku operacji INSERT i UPDATE łącznik zwróci zaktualizowane wiersze. Wymaga to, aby połączenie musiało mieć uprawnienia do odczytu danych z programu SQL Server. Klucz podstawowy jest wymagany dla następujących operacji: - GetItem - PatchItem - DeleteItem
Obsługa parametrów przekształcania agregacji	Pobieranie wierszy (wersja 2)	Obsługiwane są tylko następujące przekształcenia agregacji: - filter: umożliwia filtrowanie zestawu danych wejściowych. Obsługuje te same wyrażenia co $filter. Przykład: filter(ColName1 eq 1). - agregacja: umożliwia agregację przy użyciu jednej z następujących metod: average, , maxmin, sum, countdistinct. Przykład: aggregate(ColName2 with max as MaxValue). Można połączyć kilka operatorów rozdzielonych ukośnikami, aby wyrazić, że są one stosowane kolejno. Oznacza to, że wynikiem każdej transformacji jest dane wejściowe do następnej transformacji. Przykład: filter(ColName1 eq 4)/aggregate(ColName2 with sum as MaxWorkItemId).
Typ danych parametru formalnego jest zastępowany podczas wykonywania zapytania SQL	Wykonywanie zapytania SQL [PRZESTARZAŁE] Wykonywanie zapytania SQL (wersja 2)	Typ danych wprowadzony podczas definiowania parametru formalnego w zapytaniu SQL może zostać zastąpiony, ponieważ podstawowa implementacja łącznika określa typ za pośrednictwem podanej wartości parametru.
Operator IN używający parametrów formalnych wymaga, aby wartości zostały zdefiniowane oddzielnie	Wykonywanie zapytania SQL (wersja 2)	W przypadku używania parametrów formalnych z operatorem IN wszystkie przekazane wartości muszą być definiowane oddzielnie, a nie jako pojedynczy parametr formalny zawierający wiele wartości rozdzielonych przecinkami. Przykład: SELECT * FROM tableName WHERE columnName IN (@formalParameterA, @formalParameterB, @formalParameterC).
Niepowodzenie przy użyciu usługi Azure Sql DataWareHouse DB	Wstaw wiersz (wersja 2)	Użycie bazy danych usługi Azure SQL Datawarehouse w usłudze Power Apps powoduje niepowodzenie z powodu niezgodności składni w wykonaniu łącznika w bazie danych. Utwórz przepływ za pomocą łącznika usługi Azure SQL Datawarehouse w usłudze Power Automate, wyzwól go z usługi PowerApps lub utwórz zapytanie i użyj go w akcji Wykonaj zapytanie SQL (V2).

Znane problemy i ograniczenia dotyczące wyzwalaczy

Uwaga / Notatka

Wyłączenie i włączenie przepływu nie spowoduje zresetowania stanu wyzwalacza.

Krótki opis	Operations	Długi opis
Modyfikowanie elementu: operacje wierszy	Po zmodyfikowaniu elementu (wersja 2)	Uruchamia zarówno operacje INSERT, jak i UPDATE wierszy.
Modyfikowanie elementu: wymagania dotyczące kolumn	Po zmodyfikowaniu elementu (wersja 2)	Wymagana jest kolumna ROWVERSION.
Tworzenie elementu: wymaganie dotyczące kolumn	Po utworzeniu elementu (wersja 2)	Kolumna IDENTITY jest wymagana.
Tworzenie elementu	Po utworzeniu elementu (wersja 2)	Użyj najnowszej wartości kolumny tożsamości wstawionego wiersza jako progu (stanu wyzwalacza), aby zidentyfikować nowo wstawione wiersze później. Logika zakłada, że tożsamość każdego nowego wiersza musi być większa niż poprzednia. W związku z tym w przypadku zresetowania sekwencji tożsamości dla tabeli z powodu jawnego polecenia t-sql lub obcinania tabeli logika wyzwalacza pominie nowe wiersze dla istniejącego przepływu. Możliwe są dwa różne obejścia: najpierw można zresetować stan wyzwalacza przepływu, aktualizując kartę akcji wyzwalacza (na przykład zmienić jego nazwę, zaktualizować parametry lub dodać nowe połączenie) i zapisać zmiany. Możesz też przywrócić sekwencję tożsamości tabeli docelowej przy użyciu następującego podejścia.

Ogólne znane problemy i ograniczenia

• Wstawianie i aktualizowanie tabeli nie będzie działać, jeśli zdefiniowano wyzwalacz po stronie serwera SQL w tabeli.

  Aby rozwiązać ten problem, dostępne są następujące opcje:

  • Użyj procedury składowanej lub zapytania natywnego.
  • Usuń wyzwalacz z tabeli SQL.

• Następujące ograniczenia dotyczą używania łącznika SQL z lokalnym serwerem SQL:

  • Minimalna obsługiwana wersja lokalnego programu SQL Server to SQL Server 2005.
  • Limit rozmiaru żądania wynosi 2 MB za pośrednictwem lokalnego programu SQL Server.
  • Limit rozmiaru odpowiedzi wynosi 8 MB za pośrednictwem lokalnego programu SQL Server.

• Następujące ograniczenia dotyczą wywoływania procedury składowanej na lokalnym serwerze SQL za pośrednictwem bramy:

  • Wartości wyjściowe parametrów OUTPUT nie są zwracane. Nadal można określić wartości wejściowe parametrów OUTPUT .
  • Wartość ResultSets jest nietypowa.
  • Wartość zwracana jest niedostępna.
  • Zwracany jest tylko pierwszy zestaw wyników.
  • Schematy usługi Dynamics nie są obsługiwane w przypadku zestawów wyników.

• Następujące typy danych nie mogą być używane jako predykaty opcji zapytania:

  • date
  • datetime
  • datetime2
  • smalldatetime

• Ustawienie Wymuszanie szyfrowania nie jest obsługiwane. Domyślnie usługi SQL Database i SQL Managed Instance zabezpieczają dane klientów przez szyfrowanie danych w ruchu przy użyciu protokołu Transport Layer Security (TLS). Aby uzyskać więcej informacji, zobacz Omówienie zabezpieczeń usługi Azure SQL.

• Obsługa wielu zestawów wyników jest obecnie ograniczona do wykonywania natywnych zapytań SQL. Zwracane są tylko zestawy wyników do pierwszego pustego zestawu wyników.

  Aby rozwiązać ten problem, użyj procedur składowanych.

• Po wykonaniu zapytań SQL i procedur składowanych schemat zestawu wyników powinien zawierać unikatowe niepuste nazwy kolumn.

• W przypadku każdej operacji wewnątrz procedury składowanej, która zwraca jakiś zestaw wyników, takich jak dowolna instrukcja wewnętrzna SELECT , schemat zestawu wyników powinien zawierać unikatowe niepuste nazwy kolumn.

• Jeśli czas wykonywania przekracza 110 sekund dla zapytania SQL lub procedury składowanej, akcje upłynął limit czasu.

  Aby obejść to ograniczenie i dowiedzieć się, jak wykonywać długotrwałe procedury składowane, zobacz Długotrwałe procedury składowane SQL w usłudze Logic Apps.

• W usłudze Azure Logic Apps możesz uzyskać dostęp do prywatnego punktu końcowego w programie SQL Server tylko z poziomu środowiska usługi integracji (ISE). Aby uzyskać więcej informacji, zobacz Dostęp do sieci wirtualnych platformy Azure.

• Podczas tworzenia zapytania z wieloma filtrami może wystąpić następujący błąd: "Drzewo składni zapytania OData przekroczyło limit liczby węzłów "100". Spróbuj uprościć wyrażenia parametrów zapytania OData. Aby uniknąć tego problemu, zoptymalizuj warunki filtrowania, aby zmniejszyć ich liczbę (na przykład przy użyciu zakresów).

• Nie zaleca się przechowywania dużych ilości danych (więcej niż 30 megabajtów) w docelowych polach tabeli (e.g. xml lub typów danych tekstowych). Może to prowadzić do obniżenia wydajności akcji i wyzwalaczy, powodując błędy przekroczenia limitu czasu 504. Użyj parametru "Wybierz zapytanie", aby uwzględnić tylko stosunkowo małe pola i uniknąć dużych pól danych wyjściowych. Możesz też użyć wyspecjalizowanych magazynów plików, takich jak Usługa Azure Blob Storage.

• Operacje CRUD nie są obsługiwane w przypadku źródeł usługi Azure Synapse z powodu braku obsługi klauzul OUTPUT. Zdecydowanie zaleca się użycie dedykowanego łącznika usługi Azure SQL Data Warehouse .

• Widoki nawigatora usług Power Platform i Logic Apps są ograniczone do rozmiaru listy 10 000 tabel.

• Schemat bazy danych, który nie jest zgodny ze standardowymi identyfikatorami OData , nie jest obsługiwany (nazwa kolumny rozpoczynająca się od numeru, zawierająca znak pary zastępczej itp.). Klienci mogą użyć widoku do abstrakcji nazwy kolumn lub mogą używać właściwości rozszerzonych SQL do obsługi użycia dodatkowych znaków płaszczyzny, które są oddzielone od schematu bazy danych, zobacz: Dodawanie właściwości rozszerzonej do kolumny w tabeli.

• W przypadku używania łącznika SQL jako źródła danych dla tabel wirtualnych wartości serwera i bazy danych muszą być zgodne między źródłowym zestawem danych a używanym połączeniem. W przypadku korzystania z uwierzytelniania SQL wartości zestawu danych można ustawić na wartość domyślną, ponieważ połączenie będzie już zawierać wartości serwera i bazy danych. Jeśli wartości połączenia zestawu danych są jawnie określone, muszą być zgodne z błędami połączenia, takimi jak "Wystąpił problem. Nie można otworzyć tabeli. Spróbuj ponownie załadować lub otworzyć ponownie. Może wystąpić "nieprawidłowe źródło danych".

• Gdy zmiany schematu wystąpią w widokach używanych w przepływach usługi Power Automate, wyzwalacze mogą nie zostać wyzwolone, dopóki nowe połączenie nie zostanie utworzone w zaktualizowanym widoku — tylko odświeżanie połączenia nie jest wystarczające do zresetowania wyzwalacza względem zaktualizowanych widoków.

• Protokół 8.0 strumienia danych tabelarycznych (TDS) nie jest obecnie obsługiwany przez łącznik SQL.

Specjalne limity ograniczania przepustowości

• W różnych przypadkach łącznik SQL ma różne limity ograniczania przepustowości. W poniższej tabeli operacje natywne obejmują procedurę składowaną SQL i zapytanie SQL. CRUD oznacza operacje tworzenia, odczytu, aktualizacji i usuwania.

• Oprócz poniższych limitów ograniczanie poziomu identyfikatora połączenia jest również stosowane na podstawie łącznego czasu spędzonego przez poprzednie żądania w danym okresie.

Usługa	Środowisko	Operations	Name	Połączenia	Okres odnowienia (w sekundach)
Logic Apps i Power Automate	Środowisko udostępnione	Native	Wywołania interfejsu API na połączenie	500	10
Logic Apps i Power Automate	Środowisko udostępnione	CRUD	Wywołania interfejsu API na połączenie	100	10
Logic Apps i Power Automate	Środowisko udostępnione	Native	Współbieżne wywołania na połączenie	200	-
Logic Apps i Power Automate	Środowisko udostępnione	CRUD	Współbieżne wywołania na połączenie	125	-
Power Apps	Środowisko udostępnione	Wszystko	Wywołania interfejsu API na użytkownika	300	30
Power Apps	Środowisko udostępnione	Wszystko	Współbieżne wywołania na połączenie	125	-

Uwaga / Notatka

Współbieżne wywołania to liczba żądań w toku, które może wykonywać określone połączenie. Na przykład w przypadku wywołań natywnych usługi Azure Logic Apps jedno połączenie może wykonywać 200 współbieżnych wywołań. Wszystkie kolejne wywołania zwracają błąd 429, jeśli wszystkie 200 wywołań nadal są wykonywane. Nie istnieje limit czasu, ponieważ wywołania mogą zająć dowolną ilość czasu. Jednak celem limitu wywołań jest zapobieganie zbyt wielu długotrwałym zapytaniom z jednego połączenia i negatywnie wpływa na inne połączenia.

Jeśli na przykład połączenie wykonuje 200 wywołań w tym samym czasie, a każde wywołanie trwa 50 sekund, wszystkie inne wywołania zakończy się niepowodzeniem z błędem 429 w ciągu najbliższych 50 sekund. Po zakończeniu wykonywania co najmniej jednego zapytania i zwracaniu wyników wszystkie kolejne wywołania są przetwarzane.

Mapowanie typu danych Power Apps

Zobacz dokumentację usługi Power Apps SQL

Funkcje i operacje usługi Power Apps delegowalne do programu SQL Server

Zobacz dokumentację delegowania SQL usługi Power Apps

Parametry formalne w operacjach

Wykonaj zapytanie SQL [PRZESTARZAŁE] i wykonaj akcje zapytania SQL (V2) zezwalają na użycie parametrów formalnych. Są one definiowane jako pary klucz-wartość, gdzie key jest nazwą parametru i value jest typem danych SQL, takim jak INT lub NVARCHAR(255). Po zdefiniowaniu nazwy i typu danych zostanie wyświetlone nowe pole wejściowe dla wartości.

Migrowanie operacji V1 do odpowiednika V2

Wykonaj kroki opisane tutaj, aby przeprowadzić migrację z operacji V1 do jej odpowiednika w wersji 2.

Ważne

Przed rozpoczęciem migracji zawsze zapisz kopię aplikacji logiki, przepływu usługi Power Automate lub aplikacji Power App, aby utworzyć kopię zapasową.

Uwaga / Notatka

Wszystkie operacje w wersji 2 mają dwa dodatkowe parametry: Server Name, i Database Name. Dzięki temu operacje w wersji 2 obsługują uwierzytelnianie identyfikatorów Entra firmy Microsoft.

Typ operacji	Operacja w wersji 1	Odpowiednik operacji w wersji 2
Akcja	Usuń wiersz [PRZESTARZAŁE]	Usuń wiersz (wersja 2)
Akcja	Wykonywanie zapytania SQL [PRZESTARZAŁE]	Wykonywanie zapytania SQL (wersja 2)
Akcja	Wykonywanie procedury składowanej	Wykonywanie procedury składowanej (wersja 2)
Akcja	Pobieranie wiersza [PRZESTARZAŁE]	Pobieranie wiersza (wersja 2)
Akcja	Pobieranie wierszy [PRZESTARZAŁE]	Pobieranie wierszy (wersja 2)
Akcja	Wstaw wiersz [PRZESTARZAŁE]	Wstaw wiersz (wersja 2)
Akcja	Wyświetla tabele uwidocznione przez połączenie [PRZESTARZAŁE]	Pobieranie tabel (wersja 2)
Akcja	Aktualizuj wiersz [PRZESTARZAŁE]	Aktualizuj wiersz (wersja 2)
Wyzwalacz	Po utworzeniu elementu [PRZESTARZAŁE]	Po utworzeniu elementu (wersja 2)
Wyzwalacz	Po zmodyfikowaniu elementu [PRZESTARZAŁE]	Po zmodyfikowaniu elementu (wersja 2)

Identyfikowanie akcji w wersji 1

Power Automate

W przypadku operacji usługi Power Automate otwórz operacje Code View programu SQL Server i sprawdź host.operationId wartość. Jeśli wartość jest zgodna z jednym z identyfikatorów operacji programu SQL Server V1 wymienionych powyżej, ta operacja musi zostać zmigrowana do jej odpowiednika w wersji 2.

Na przykład PatchItem operacja musi zostać zmigrowana do PatchItem_V2elementu .

Aplikacje logiki

Aby uzyskać omówienie usługi Logic Apps zawierającej co najmniej jedną operację programu SQL Server W1:

1. Otwieranie witryny Azure Portal

2. Otwieranie Eksploratora usługi Azure Resource Graph

3. Wprowadź identyfikator subskrypcji w symbolu zastępczym i uruchom poniższe zapytanie, aby uzyskać podsumowanie usługi Logic Apps, które wymagają twojej uwagi i liczby akcji programu SQL Server V1 w każdym z nich.

   • Skrypt Eksploratora usługi Azure Resource Graph umożliwiający identyfikowanie usługi Logic Apps za pomocą akcji w wersji 1.

     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
     

   • Skrypt Eksploratora usługi Azure Resource Graph umożliwiający identyfikację usługi Logic Apps z wyzwalaczami w wersji 1.

     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
     

Migrowanie do operacji w wersji 2 w środowisku użytkownika

Migrowanie usługi Logic Apps i automatyzacji usługi Power Automate

1. Otwórz przepływ aplikacji logiki lub usługi Power Automate zawierający akcję V1.

2. Dodaj akcję bezpośrednio przed lub po akcji V1, którą chcesz zaktualizować.

   

3. Kliknij łącznik programu SQL Server i poszukaj odpowiednika akcji migrowanej w wersji 2.

   

4. Wybierz połączenie, które ma być używane w akcji V2.

   Wskazówka

   Akcje w wersji 2 obsługują typy uwierzytelniania Identyfikator entra firmy Microsoft. Usługa Logic Apps obsługuje również uwierzytelnianie tożsamości zarządzanej w przypadku akcji w wersji 2.

   Zobacz więcej w sekcji Uwierzytelnianie .

5. Wprowadź nazwę serwera.

   • Jeśli używasz Windows Authentication programu lub SQL Server Authentication, wybierz nazwę serwera z listy rozwijanej.

     

   • Jeśli używasz Service principaltypu , Microsoft Entra ID lub Managed Identity uwierzytelniania, kliknij pozycję "Wprowadź wartość niestandardową" na liście rozwijanej, a następnie wprowadź nazwę serwera.

     

6. Wprowadź bazę danych, wybierając ją z listy rozwijanej.

   

7. Wprowadź pozostałe parametry, aby były takie same jak akcja V1.

8. Po zakończeniu konfigurowania akcji V1 usuń akcję V2.

   

   Ważne

   Usunięcie akcji V1 spowoduje usunięcie całej zawartości dynamicznej z wersji 1; Należy ponownie dodać zawartość dynamiczną w wersji 2.

Migrowanie usługi Power Apps

1. Otwórz aplikację, która musi zostać zaktualizowana.

2. Usuń wszystkie źródła danych SQL.

   Uwaga / Notatka

   Formuły korzystające z usuniętych źródeł danych będą wyświetlać błąd, jest to oczekiwane i zostanie naprawione w następnych krokach.

   

3. Otwórz kartę Nadchodzące funkcje w obszarze Ustawienia i wpisz ciąg "SQL" w polu wyszukiwania. Zostanie udostępniona funkcja "Włącz rozszerzony łącznik programu Microsoft SQL Server".

   

4. Włącz funkcję "Włącz rozszerzony łącznik programu Microsoft SQL Server".

   Uwaga / Notatka

   Ta funkcja jest domyślnie włączona dla wszystkich nowych aplikacji Power Apps.

   

5. Odczytano źródło danych.

   

6. Zweryfikuj zachowanie aplikacji, szczególnie w tabelach, które obsługują typy danych DateTime.

7. Zapisz aplikację.

Migrowanie operacji za pomocą widoku kodu w usłudze Azure Logic Apps

W przypadku bardziej złożonych scenariuszy akcje można migrować, aktualizując definicję przepływu pracy.

1. Zidentyfikuj nazwę operacji (wyzwalacz i/lub akcje), które należy zmigrować w aplikacji logiki.

2. Otwórz projektanta aplikacji logiki do zmodyfikowania, a następnie kliknij pozycję "Widok kodu".

   

3. Dla każdej akcji, która musi zostać zmigrowana:

   1. Znajdowanie właściwości akcji lub ścieżki wyzwalacza
   2. Zastąp element /datasets/default/ we właściwości path wartością /v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/.

4. Po zaktualizowaniu wszystkich operacji kliknij pozycję "Projektant".

   

5. Sprawdź, czy wszystkie operacje zostały pomyślnie zmigrowane.

   • Nazwa serwera i bazy danych powinna zostać wypełniona wartościami połączenia.
   • Wszystkie inne parametry powinny być również wypełniane.

   

6. Zapisz i przetestuj aplikację logiki.

Wskazówka

W razie potrzeby po przeprowadzeniu migracji akcji do wersji 2 można zaktualizować nazwę i połączenie operacji.

Oto przykład migrowania pobierania wierszy [PRZESTARZAŁE].

1. Otwórz pozycję "Widok kodu".

2. Znajdź akcję "Pobierz wiersze [PRZESTARZAŁE]".

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

3. Zaktualizuj segment zestawów danych ścieżki za pomocą podanego zastąpienia powyżej.

   "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. Kliknij pozycję "Projektant", aby wrócić do widoku początkowego i sprawdzić, czy akcja została poprawnie wypełniona.

Migrowanie operacji za pomocą edytowania definicji przepływu

1. Zidentyfikuj nazwę operacji (wyzwalacz i/lub akcje), które należy zmigrować w aplikacji logiki.

2. Wyeksportuj przepływ jako pakiet (ZIP).

   

3. Wyodrębnij plik ZIP.

4. Otwórz folder, w którym został wyodrębniony plik ZIP.

5. Przejdź do Microsoft.Flowfolderu , a następnie flowsidentyfikator GUID o nazwie .

6. Otwórz plik definition.json w edytorze tekstów.

   • Aby zwiększyć czytelność, sformatuj kod JSON.

7. Dla każdej akcji, która musi zostać zmigrowana:

   1. Znajdowanie właściwości akcji lub wyzwalacza

   2. Zaktualizuj inputs.host.operationId właściwość do równoważnej wersji 2. Wartość można znaleźć w dokumentacji operacji.

      

   3. Dodaj do inputs.parameters dwóch właściwości:

      • server z wartością default
      • database z wartością default

8. Zapisywanie pliku definition.json

9. Wróć do lokalizacji manifest.json i Microsoft.Flow

10. Wybierz zarówno Microsoft.Flow, jak i manifest.json, i kompresuj do pliku ZIP.

    Ważne

    Upewnij się, że nowy plik ZIP ma dokładnie taką samą strukturę plików i folderów jak oryginalny plik ZIP.

    Folder Microsoft.Flow i plik manifest.json muszą znajdować się w katalogu głównym nowego pliku ZIP. Niepowodzenie tej samej struktury spowoduje błędy podczas przekazywania pakietu.

    

11. Przejdź do przepływów w usłudze Power Automate.

12. Zaimportuj zaktualizowany przepływ, importując pakiet. Wybierz nowo utworzony plik ZIP i przekaż pakiet.

    

13. Wybierz konfigurację importu (importuj/utwórz nową), a następnie wybierz połączenia, które będą używane przez przepływ.

14. Po zakończeniu importowania otwórz nowy/zaktualizowany przepływ.

15. Sprawdź, czy akcje zostały zaktualizowane

• Nazwa serwera i bazy danych powinna zostać wypełniona wartościami połączenia.

• Wszystkie inne parametry powinny być również wypełniane.

  

Wskazówka

W razie potrzeby po przeprowadzeniu migracji akcji do wersji 2 można zaktualizować nazwę i połączenie operacji w środowisku użytkownika.

Oto przykład migrowania wykonywania zapytania SQL [PRZESTARZAŁE].

1. Otwórz pozycję "Widok kodu".

2. Znajdź akcję "Wykonaj zapytanie SQL [PRZESTARZAŁE]".

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

3. Zaktualizuj identyfikator operacji przy użyciu równoważnego identyfikatora operacji w wersji 2, a następnie dodaj parametry serwera i bazy danych z wartością default , jak pokazano powyżej.

   "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",
         },
         // ..
       }
     }
   }
   
   

Ważne

Połączenia zintegrowane z identyfikatorem entra firmy Microsoft (Azure Commercial) są domyślnie wyłączone w środowiskach GCC (US Government). Aby włączyć te typy połączeń, ustawienie Połącz z platformą Azure Commercial musi być włączone w centrum administracyjnym platformy Power Platform przez administratora dzierżawy.

Włączenie tego ustawienia umożliwia nawiązywanie połączeń z zasobami w usłudze Azure Commercial, które działają i wysyłają dane poza granicą zgodności platformy Power Platform US Government. Jest to szczególnie używane do zezwalania na dostęp do zasobów komercyjnych z wersji chmury GCC łączników platformy Power Platform.

Microsoft Entra ID Integrated (Azure Commercial) to jedyny typ uwierzytelniania, który działa ze środowisk rządu USA (GCC) do zasobów komercyjnych platformy Azure.

Uwierzytelnianie komercyjne platformy Azure jest domyślnie wyłączone:

Ustawienie Połącz z platformą Azure Commercial w centrum administracyjnym platformy Power Platform:

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Uwierzytelnianie certyfikatu klienta	Podaj poświadczenia identyfikatora entra firmy Microsoft przy użyciu certyfikatu PFX i hasła	Wszystkie regiony	Udostępnialne
Microsoft Entra ID Integrated	Użyj identyfikatora Entra firmy Microsoft, aby uzyskać dostęp do bazy danych SQL.	Wszystkie regiony z wyjątkiem instytucji rządowych USA (GCC)	Nie można udostępniać
Microsoft Entra ID Integrated (Azure Commercial)	Użyj identyfikatora Entra firmy Microsoft, aby uzyskać dostęp do bazy danych SQL w usłudze Azure Commercial.	Tylko instytucje rządowe USA (GCC)	Nie można udostępniać
Microsoft Entra ID Integrated (Azure Government)	Użyj identyfikatora Entra firmy Microsoft, aby uzyskać dostęp do bazy danych SQL w usłudze Azure Government.	Tylko instytucje rządowe USA (GCC)	Nie można udostępniać
Jednostka usługi (aplikacja Microsoft Entra ID)	Użyj aplikacji Microsoft Entra ID, aby uzyskać dostęp do bazy danych SQL.	Wszystkie regiony	Udostępnialne
Uwierzytelnianie programu SQL Server	Użyj nazwy konta i hasła, aby uzyskać dostęp do bazy danych SQL.	Wszystkie regiony	Udostępnialne
Uwierzytelnianie Windows	Użyj lokalnej nazwy konta microsoft Entra ID i hasła, aby uzyskać dostęp do bazy danych SQL.	Wszystkie regiony	Udostępnialne
Uwierzytelnianie systemu Windows (nieudostępne)	Użyj lokalnej nazwy konta microsoft Entra ID i hasła, aby uzyskać dostęp do bazy danych SQL.	Wszystkie regiony	Nie można udostępniać
Domyślne [PRZESTARZAŁE]	Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.	Wszystkie regiony	Nie można udostępniać

Uwierzytelnianie certyfikatu klienta

Identyfikator uwierzytelniania: certOauth

Dotyczy: Wszystkie regiony

Podaj poświadczenia identyfikatora entra firmy Microsoft przy użyciu certyfikatu PFX i hasła

Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs

Name	Typ	Description	Wymagane
Tenant	ciąg		Prawda
ID klienta	ciąg	Identyfikator klienta aplikacji Microsoft Entra ID
Klucz tajny certyfikatu klienta	certyfikat klienta	Klucz tajny certyfikatu klienta dozwolony przez tę aplikację	Prawda

Microsoft Entra ID Zintegrowany

Identyfikator uwierzytelniania: oauth

Dotyczy: wszystkie regiony z wyjątkiem instytucji rządowych USA (GCC)

Użyj identyfikatora Entra firmy Microsoft, aby uzyskać dostęp do bazy danych SQL.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Microsoft Entra ID Integrated (Azure Commercial)

Identyfikator uwierzytelniania: oauthCom

Dotyczy: tylko rząd USA (GCC)

Użyj identyfikatora Entra firmy Microsoft, aby uzyskać dostęp do bazy danych SQL w usłudze Azure Commercial.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Microsoft Entra ID Integrated (Azure Government)

Identyfikator uwierzytelniania: oauth

Dotyczy: tylko rząd USA (GCC)

Użyj identyfikatora Entra firmy Microsoft, aby uzyskać dostęp do bazy danych SQL w usłudze Azure Government.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Jednostka usługi (aplikacja Microsoft Entra ID)

Identyfikator uwierzytelniania: oauthSP

Dotyczy: Wszystkie regiony

Użyj aplikacji Microsoft Entra ID, aby uzyskać dostęp do bazy danych SQL.

Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs

Name	Typ	Description	Wymagane
Tenant	ciąg		Prawda
ID klienta	ciąg		Prawda
Tajemnica klienta	securestring		Prawda

Uwierzytelnianie programu SQL Server

Identyfikator uwierzytelniania: sqlAuthentication

Dotyczy: Wszystkie regiony

Użyj nazwy konta i hasła, aby uzyskać dostęp do bazy danych SQL.

Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs

Name	Typ	Description	Wymagane
Nazwa serwera SQL	ciąg	Określ nazwę serwera SQL (serwer[:p ort])	Prawda
Nazwa bazy danych SQL	ciąg	Nazwa bazy danych SQL	Prawda
Nazwa użytkownika	securestring	Poświadczenia nazwy użytkownika	Prawda
Hasło	securestring	Poświadczenie hasła	Prawda
Gateway	gatewaySetting	Brama lokalna (zobacz, aby https://docs.microsoft.com/data-integration/gateway uzyskać więcej informacji

Uwierzytelnianie systemu Windows

Identyfikator uwierzytelniania: windowsAuthentication

Dotyczy: Wszystkie regiony

Użyj lokalnej nazwy konta microsoft Entra ID i hasła, aby uzyskać dostęp do bazy danych SQL.

Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs

Name	Typ	Description	Wymagane
Nazwa serwera SQL	ciąg	Określ nazwę serwera SQL (serwer[:p ort])	Prawda
Nazwa bazy danych SQL	ciąg	Nazwa bazy danych SQL	Prawda
Nazwa użytkownika	securestring	Poświadczenia nazwy użytkownika	Prawda
Hasło	securestring	Poświadczenie hasła	Prawda
Gateway	gatewaySetting	Brama lokalna (zobacz, aby https://docs.microsoft.com/data-integration/gateway uzyskać więcej informacji	Prawda

Uwierzytelnianie systemu Windows (nieudostępne)

Identyfikator uwierzytelniania: windowsAuthenticationNonShared

Dotyczy: Wszystkie regiony

Użyj lokalnej nazwy konta microsoft Entra ID i hasła, aby uzyskać dostęp do bazy danych SQL.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Name	Typ	Description	Wymagane
Nazwa użytkownika	securestring	Poświadczenia nazwy użytkownika	Prawda
Hasło	securestring	Poświadczenie hasła	Prawda
Gateway	gatewaySetting	Brama lokalna (zobacz, aby https://docs.microsoft.com/data-integration/gateway uzyskać więcej informacji	Prawda

Domyślne [PRZESTARZAŁE]

Dotyczy: Wszystkie regiony

Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Name	Typ	Description	Wymagane
Nazwa serwera SQL	ciąg	Nazwa serwera SQL	Prawda
Nazwa bazy danych SQL	ciąg	Nazwa bazy danych SQL	Prawda
Typ uwierzytelniania	ciąg	Typ uwierzytelniania w celu nawiązania połączenia z bazą danych
Nazwa użytkownika	securestring	Poświadczenia nazwy użytkownika	Prawda
Hasło	securestring	Poświadczenie hasła	Prawda
Gateway	gatewaySetting	Brama lokalna (zobacz, aby https://docs.microsoft.com/data-integration/gateway uzyskać więcej informacji

Limity ograniczania

Nazwa	Wywołania	Okres odnowienia
Wywołania interfejsu API na połączenie	100	10 sekund

Akcje

Aktualizuj wiersz (wersja 2)	Ta operacja aktualizuje istniejący wiersz w tabeli.
Aktualizuj wiersz [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Update row (V2). Ta operacja aktualizuje istniejący wiersz w tabeli.
Pobieranie tabel (wersja 2)	Ta operacja pobiera tabele z bazy danych.
Pobieranie wiersza (wersja 2)	Ta operacja pobiera wiersz z tabeli.
Pobieranie wiersza [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz wiersz (wersja 2). Ta operacja pobiera wiersz z tabeli.
Pobieranie wierszy (wersja 2)	Ta operacja pobiera wiersze z tabeli.
Pobieranie wierszy [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz wiersze (wersja 2). Ta operacja pobiera wiersze z tabeli.
Przekształcanie danych przy użyciu dodatku Power Query	Przekształcanie danych przy użyciu dodatku Power Query. Uwaga: ta operacja nie działa podczas nawiązywania połączenia przy użyciu programu SQL Microsoft Entra ID.
Usuń wiersz (wersja 2)	Ta operacja usuwa wiersz z tabeli.
Usuń wiersz [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Usuń wiersz (V2). Ta operacja usuwa wiersz z tabeli.
Wstaw wiersz (wersja 2)	Ta operacja wstawia nowy wiersz do tabeli.
Wstaw wiersz [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Wstaw wiersz (wersja 2). Ta operacja wstawia nowy wiersz do tabeli.
Wykonywanie procedury składowanej	Ta operacja uruchamia procedurę składowaną.
Wykonywanie procedury składowanej (wersja 2)	Ta operacja uruchamia procedurę składowaną.
Wykonywanie zapytania SQL (wersja 2)	Wykonywanie zapytania SQL (wersja 2)
Wykonywanie zapytania SQL [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Wykonaj zapytanie SQL (V2). Wykonywanie zapytania SQL
Wyświetla tabele uwidocznione przez połączenie [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz tabele (wersja 2). Wyświetla tabele uwidocznione przez połączenie

Aktualizuj wiersz (wersja 2)

Identyfikator operacji:

PatchItem_V2

Ta operacja aktualizuje istniejący wiersz w tabeli.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa serwera	server	True	string	Nazwa serwera SQL
Nazwa bazy danych	database	True	string	Nazwa bazy danych
Nazwa tabeli	table	True	string	Nazwa tabeli
Identyfikator wiersza	id	True	string	Unikatowy identyfikator wiersza do zaktualizowania
Row	item	True	dynamic	Wiersz ze zaktualizowanymi wartościami

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Aktualizuj wiersz [PRZESTARZAŁE]

Identyfikator operacji:

PatchItem

Ta akcja została przestarzała. Zamiast tego użyj polecenia Update row (V2).

Ta operacja aktualizuje istniejący wiersz w tabeli.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa tabeli	table	True	string	Nazwa tabeli
Identyfikator wiersza	id	True	string	Unikatowy identyfikator wiersza do zaktualizowania
Row	item	True	dynamic	Wiersz ze zaktualizowanymi wartościami

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Pobieranie tabel (wersja 2)

Identyfikator operacji:

GetTables_V2

Ta operacja pobiera tabele z bazy danych.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa serwera	server	True	string	Nazwa serwera SQL
Nazwa bazy danych	database	True	string	Nazwa bazy danych

Zwraca

Reprezentuje listę tabel.

Body

TablesList

Pobieranie wiersza (wersja 2)

Identyfikator operacji:

GetItem_V2

Ta operacja pobiera wiersz z tabeli.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa serwera	server	True	string	Nazwa serwera SQL
Nazwa bazy danych	database	True	string	Nazwa bazy danych
Nazwa tabeli	table	True	string	Nazwa tabeli SQL
Identyfikator wiersza	id	True	string	Unikatowy identyfikator wiersza do pobrania

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Pobieranie wiersza [PRZESTARZAŁE]

Identyfikator operacji:

GetItem

Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz wiersz (wersja 2).

Ta operacja pobiera wiersz z tabeli.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa tabeli	table	True	string	Nazwa tabeli SQL
Identyfikator wiersza	id	True	string	Unikatowy identyfikator wiersza do pobrania

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Pobieranie wierszy (wersja 2)

Identyfikator operacji:

GetItems_V2

Ta operacja pobiera wiersze z tabeli.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa serwera	server	True	string	Nazwa serwera SQL
Nazwa bazy danych	database	True	string	Nazwa bazy danych
Nazwa tabeli	table	True	string	Nazwa tabeli SQL
Przekształcenie agregacji	$apply		string	Sekwencja przekształceń agregacji protokołu OData
Filtruj zapytanie	$filter		string	Zapytanie filtru ODATA ograniczające zwracane wpisy (np. stringColumn eq 'string' OR numberColumn lt 123).
Zamów według	$orderby		string	Zapytanie ODATA orderBy służące do określania kolejności wpisów.
Pomiń liczbę	$skip		integer	Liczba wpisów do pominięcia (wartość domyślna = 0).
Liczba pierwszych	$top		integer	Łączna liczba wpisów do pobrania (wartość domyślna = wszystkie).
Wybieranie zapytania	$select		string	Określone pola do pobrania z wpisów (wartość domyślna = wszystkie).

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Pobieranie wierszy [PRZESTARZAŁE]

Identyfikator operacji:

GetItems

Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz wiersze (wersja 2).

Ta operacja pobiera wiersze z tabeli.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa tabeli	table	True	string	Nazwa tabeli SQL
Przekształcenie agregacji	$apply		string	Sekwencja przekształceń agregacji protokołu OData
Filtruj zapytanie	$filter		string	Zapytanie filtru ODATA ograniczające zwracane wpisy (np. stringColumn eq 'string' OR numberColumn lt 123).
Zamów według	$orderby		string	Zapytanie ODATA orderBy służące do określania kolejności wpisów.
Pomiń liczbę	$skip		integer	Liczba wpisów do pominięcia (wartość domyślna = 0).
Liczba pierwszych	$top		integer	Łączna liczba wpisów do pobrania (wartość domyślna = wszystkie).
Wybieranie zapytania	$select		string	Określone pola do pobrania z wpisów (wartość domyślna = wszystkie).

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Przekształcanie danych przy użyciu dodatku Power Query

Identyfikator operacji:

SqlExecutePassThroughPowerQuery

Przekształcanie danych przy użyciu dodatku Power Query. Uwaga: ta operacja nie działa podczas nawiązywania połączenia przy użyciu programu SQL Microsoft Entra ID.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
kwerenda	query		mquery	Tekst zapytania

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Usuń wiersz (wersja 2)

Identyfikator operacji:

DeleteItem_V2

Ta operacja usuwa wiersz z tabeli.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa serwera	server	True	string	Nazwa serwera SQL
Nazwa bazy danych	database	True	string	Nazwa bazy danych
Nazwa tabeli	table	True	string	Nazwa tabeli
Identyfikator wiersza	id	True	string	Unikatowy identyfikator wiersza do usunięcia

Usuń wiersz [PRZESTARZAŁE]

Identyfikator operacji:

DeleteItem

Ta akcja została przestarzała. Zamiast tego użyj polecenia Usuń wiersz (V2).

Ta operacja usuwa wiersz z tabeli.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa tabeli	table	True	string	Nazwa tabeli
Identyfikator wiersza	id	True	string	Unikatowy identyfikator wiersza do usunięcia

Wstaw wiersz (wersja 2)

Identyfikator operacji:

PostItem_V2

Ta operacja wstawia nowy wiersz do tabeli.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa serwera	server	True	string	Nazwa serwera SQL
Nazwa bazy danych	database	True	string	Nazwa bazy danych
Nazwa tabeli	table	True	string	Nazwa tabeli
Row	item	True	dynamic	Wiersz do wstawienia do określonej tabeli

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Wstaw wiersz [PRZESTARZAŁE]

Identyfikator operacji:

PostItem

Ta akcja została przestarzała. Zamiast tego użyj polecenia Wstaw wiersz (wersja 2).

Ta operacja wstawia nowy wiersz do tabeli.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa tabeli	table	True	string	Nazwa tabeli
Row	item	True	dynamic	Wiersz do wstawienia do określonej tabeli

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Wykonywanie procedury składowanej

Identyfikator operacji:

ExecuteProcedure

Ta operacja uruchamia procedurę składowaną.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa procedury	procedure	True	string	Nazwa procedury składowanej
Lista parametrów	parameters	True	dynamic	Parametry wejściowe procedury składowanej

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Wykonywanie procedury składowanej (wersja 2)

Identyfikator operacji:

ExecuteProcedure_V2

Ta operacja uruchamia procedurę składowaną.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa serwera	server	True	string	Nazwa serwera SQL
Nazwa bazy danych	database	True	string	Nazwa bazy danych
Nazwa procedury	procedure	True	string	Nazwa procedury składowanej
Lista parametrów	parameters	True	dynamic	Parametry wejściowe procedury składowanej

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Wykonywanie zapytania SQL (wersja 2)

Identyfikator operacji:

ExecutePassThroughNativeQuery_V2

Wykonywanie zapytania SQL (wersja 2)

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa serwera	server	True	string	Nazwa serwera SQL
Nazwa bazy danych	database	True	string	Nazwa bazy danych
Query	query	True	dynamic	Treść zapytania

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Wykonywanie zapytania SQL [PRZESTARZAŁE]

Identyfikator operacji:

ExecutePassThroughNativeQuery

Ta akcja została przestarzała. Zamiast tego użyj polecenia Wykonaj zapytanie SQL (V2).

Wykonywanie zapytania SQL

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Query	query	True	dynamic	Treść zapytania

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Wyświetla tabele uwidocznione przez połączenie [PRZESTARZAŁE]

Identyfikator operacji:

GetTables

Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz tabele (wersja 2).

Wyświetla tabele uwidocznione przez połączenie

Zwraca

Reprezentuje listę tabel.

Body

TablesList

Wyzwalacze

Po utworzeniu elementu (wersja 2)	Wyzwala przepływ po utworzeniu elementu w języku SQL
Po utworzeniu elementu [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Po utworzeniu elementu (wersja 2). Wyzwala przepływ po utworzeniu elementu w języku SQL
Po zmodyfikowaniu elementu (wersja 2)	Wyzwala przepływ, gdy element jest modyfikowany/wstawiany w języku SQL
Po zmodyfikowaniu elementu [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Gdy element jest modyfikowany (wersja 2). Wyzwala przepływ, gdy element jest modyfikowany/wstawiany w języku SQL

Po utworzeniu elementu (wersja 2)

Identyfikator operacji:

GetOnNewItems_V2

Wyzwala przepływ po utworzeniu elementu w języku SQL

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa serwera	server	True	string	Nazwa serwera SQL
Nazwa bazy danych	database	True	string	Nazwa bazy danych
Nazwa tabeli	table	True	string	Nazwa tabeli SQL
Filtruj zapytanie	$filter		string	Zapytanie filtru ODATA ograniczające zwracane wpisy (np. stringColumn eq 'string' OR numberColumn lt 123).
Liczba pierwszych	$top		integer	Łączna liczba wpisów do pobrania (wartość domyślna = wszystkie).
Zamów według	$orderby		string	Zapytanie ODATA orderBy służące do określania kolejności wpisów.
Wybieranie zapytania	$select		string	Określone pola do pobrania z wpisów (wartość domyślna = wszystkie).

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Po utworzeniu elementu [PRZESTARZAŁE]

Identyfikator operacji:

GetOnNewItems

Ta akcja została przestarzała. Zamiast tego użyj polecenia Po utworzeniu elementu (wersja 2).

Wyzwala przepływ po utworzeniu elementu w języku SQL

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa tabeli	table	True	string	Nazwa tabeli SQL
Filtruj zapytanie	$filter		string	Zapytanie filtru ODATA ograniczające zwracane wpisy (np. stringColumn eq 'string' OR numberColumn lt 123).
Liczba pierwszych	$top		integer	Łączna liczba wpisów do pobrania (wartość domyślna = wszystkie).
Zamów według	$orderby		string	Zapytanie ODATA orderBy służące do określania kolejności wpisów.
Wybieranie zapytania	$select		string	Określone pola do pobrania z wpisów (wartość domyślna = wszystkie).

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Po zmodyfikowaniu elementu (wersja 2)

Identyfikator operacji:

GetOnUpdatedItems_V2

Wyzwala przepływ, gdy element jest modyfikowany/wstawiany w języku SQL

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa serwera	server	True	string	Nazwa serwera SQL
Nazwa bazy danych	database	True	string	Nazwa bazy danych
Nazwa tabeli	table	True	string	Nazwa tabeli SQL
Filtruj zapytanie	$filter		string	Zapytanie filtru ODATA ograniczające zwracane wpisy (np. stringColumn eq 'string' OR numberColumn lt 123).
Liczba pierwszych	$top		integer	Łączna liczba wpisów do pobrania (wartość domyślna = wszystkie).
Zamów według	$orderby		string	Zapytanie ODATA orderBy służące do określania kolejności wpisów.
Wybieranie zapytania	$select		string	Określone pola do pobrania z wpisów (wartość domyślna = wszystkie).

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Po zmodyfikowaniu elementu [PRZESTARZAŁE]

Identyfikator operacji:

GetOnUpdatedItems

Ta akcja została przestarzała. Zamiast tego użyj polecenia Gdy element jest modyfikowany (wersja 2).

Wyzwala przepływ, gdy element jest modyfikowany/wstawiany w języku SQL

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Nazwa tabeli	table	True	string	Nazwa tabeli SQL
Filtruj zapytanie	$filter		string	Zapytanie filtru ODATA ograniczające zwracane wpisy (np. stringColumn eq 'string' OR numberColumn lt 123).
Liczba pierwszych	$top		integer	Łączna liczba wpisów do pobrania (wartość domyślna = wszystkie).
Zamów według	$orderby		string	Zapytanie ODATA orderBy służące do określania kolejności wpisów.
Wybieranie zapytania	$select		string	Określone pola do pobrania z wpisów (wartość domyślna = wszystkie).

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Definicje

Tabela

Reprezentuje tabelę.

Nazwa	Ścieżka	Typ	Opis
Name	Name	string	Nazwa tabeli. Nazwa jest używana w czasie wykonywania.
Nazwa wyświetlana	DisplayName	string	Nazwa wyświetlana tabeli.
Właściwości dynamiczne	DynamicProperties	object	Dodatkowe właściwości tabeli udostępniane przez łącznik klientom.

TablesList

Reprezentuje listę tabel.

Nazwa	Ścieżka	Typ	Opis
value	value	array of Table	Lista tabel