Snowflake
Łącznik snowflake umożliwia tworzenie aplikacji kanwy i powierzchni danych snowflake w tabelach wirtualnych, a także umożliwia szybsze przetwarzanie i analizę danych w porównaniu z tradycyjnymi rozwiązaniami.
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 z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Obsługa płatka śniegu |
| adres URL | https://www.snowflake.com/support |
| support@snowflake.com |
| Metadane łącznika | |
|---|---|
| Publisher | Snowflake |
| Witryna internetowa | https://www.snowflake.com |
| Zasady ochrony prywatności | https://www.snowflake.com/privacy-policy |
| Kategorie | Dane; Marketing |
Szczegółowe informacje o konektorze
W tym artykule opisano możliwości i akcje łącznika Snowflake.
Obsługiwane możliwości usługi Power Automate
- Użytkownicy mogą tworzyć przepływy i dodawać akcje do wykonywania i uzyskiwania wyników niestandardowych instrukcji SQL za pomocą połączenia Snowflake.
Obsługiwane możliwości usługi Power Apps
- Użytkownicy powinni najpierw tworzyć tabele wirtualne, a następnie ładować je do aplikacji za pomocą połączenia Snowflake (połączenie utworzone przy użyciu tylko uwierzytelniania jednostki usługi). Dowiedz się, jak tworzyć tabele wirtualne: tworzenie i edytowanie tabel wirtualnych za pomocą usługi Microsoft Dataverse — Power Apps | Microsoft Learn.
Obsługiwane możliwości usługi Logic Apps
- Użytkownicy mogą tworzyć przepływy i dodawać akcje do wykonywania i uzyskiwania wyników niestandardowych instrukcji SQL za pomocą połączenia Snowflake.
Obsługa sieci wirtualnej
Dzięki obsłudze usługi Azure Virtual Network dla platformy Power Platform użytkownicy mogą integrować platformę Power Platform z zasobami w sieci wirtualnej bez ujawniania ich za pośrednictwem publicznego Internetu. Aby nawiązać połączenie z siecią wirtualną, wykonaj oba kroki wymienione poniżej.
- Dowiedz się, jak skonfigurować usługę Azure Private Link i aplikację Snowflake
- Dowiedz się, jak skonfigurować obsługę sieci wirtualnej dla platformy Power Platform
Aby dowiedzieć się więcej na temat sieci wirtualnej, zobacz Omówienie pomocy technicznej dla sieci wirtualnej.
Wymagania wstępne
- Użytkownicy muszą mieć identyfikator Entra firmy Microsoft na potrzeby autoryzacji zewnętrznej. Przepływ autoryzacji dla usługi PowerApps korzysta z jednostki usługi, a usługa Power Automate będzie obsługiwać zarówno przepływy Service-Principal, jak i w imieniu użytkownika.
- Użytkownicy muszą mieć licencję usługi Power Apps w warstwie Premium.
- Użytkownicy muszą mieć konto snowflake.
Kilka kwestii, które należy wziąć pod uwagę w odniesieniu do konfiguracji do korzystania z łącznika snowflake
- Serwer autoryzacji może udzielić klientowi OAuth tokenu dostępu w imieniu użytkownika, o którym mowa
DELEGATED BASED AUTH. - Serwer autoryzacji może udzielić klientowi OAuth tokenu dostępu dla samego klienta OAuth, o nazwie
SP BASED AUTH. - W przypadku klienta Oauth pamiętaj o dodaniu identyfikatora URI przekierowania (opartego na sieci Web) dla delegowanego elementu
AUTH.
Identyfikator URI przekierowania —https://global.consent.azure-apim.net/redirect/snowflakev2
- Należy utworzyć integrację zabezpieczeń z odbiorcami.
- W przypadku uwierzytelniania delegowanego,
external_oauth_token_user_mapping_claim = 'upn' - W przypadku uwierzytelniania opartego na sp,
external_oauth_token_user_mapping_claim = 'sub' - Podczas tworzenia integracji zabezpieczeń opisz utworzoną integrację i sprawdź, czy rola nadana użytkownikowi aplikacji Snowflake znajduje się na liście zablokowanych, czy nie. Jeśli na liście zablokowanych, zmień lub usuń rolę użytkownika na liście zablokowanych.
- Upewnij się, że
login_namerole i są poprawnie ustawione na koncie usługi Snowflake. Można to sprawdzić za pomocą karty Administratorzy > Użytkownicy i role > Wybierz użytkownika i Edytuj szczegóły użytkownika.
Kroki konfiguracji
A. Konfigurowanie zasobu OAuth w identyfikatorze Entra firmy Microsoft
- Przejdź do witryny Microsoft Azure Portal i uwierzytelnij się.
- Przejdź do pozycji Microsoft Entra ID.
- Kliknij pozycję Rejestracje aplikacji.
- Kliknij pozycję Nowa rejestracja.
- Wprowadź wartość "Zasób OAuth snowflake" lub podobną wartość jako nazwę.
- Sprawdź, czy obsługiwane typy kont są ustawione na pojedynczą dzierżawę.
- Kliknij pozycję Zarejestruj.
- Kliknij pozycję Uwidaczniaj interfejs API.
- Kliknij link obok identyfikatora URI identyfikatora aplikacji , aby dodać identyfikator URI identyfikatora aplikacji. Identyfikator URI identyfikatora aplikacji będzie mieć format
Application ID URI <api://9xxxxxxxxxxxxxxxxxx> - W przypadku delegowanego uwierzytelniania (zrzuty ekranu tutaj):
- Kliknij pozycję Dodaj zakres, aby dodać zakres reprezentujący rolę Snowflake.
- Wybierz, kto może wyrazić zgodę.
- Dodaj opis.
- Kliknij pozycję Dodaj zakres, aby zapisać.
Przykład:session:scope:analyst
OR
- W przypadku uwierzytelniania jednostki usługi (zrzuty ekranu tutaj):
Aby dodać rolę Snowflake jako rolę dla przepływów OAuth, w których klient programowy żąda tokenu dostępu dla siebie:Kliknij pozycję Manifest.
appRolesZnajdź element .Wprowadź rolę aplikacji z następującymi ustawieniami. Rola snowflake powinna być rolą, która ma dostęp do magazynu i uprawnieniami użycia w schemacie (sprawdź tutaj , aby uzyskać szczegółowe informacje na temat wartości manifestu).
Zobacz przykładową definicję poniżej:
Manifesty roli aplikacji w następujący sposób. Unikaj używania ról o wysokim poziomie uprawnień, takich jakACCOUNTADMIN,SECURITYADMINlubORGADMIN."appRoles":[ { "allowedMemberTypes": [ "Application" ], "description": "Analyst.", "displayName": "Analyst", "id": "3ea51f40-2ad7-4e79-aa18-12c45156dc6a", "isEnabled": true, "lang": null, "origin": "Application", "value": "session:role:analyst" } ]Kliknij pozycję Zapisz
- Opcjonalnie, jeśli integracja zabezpieczeń jest już używana w rozwiązaniu Snowflake z innym produktem firmy Microsoft, takim jak PowerBI i innym mapowaniem oświadczeń, manifest będzie musiał zostać zmodyfikowany. Manifest będzie musiał emitować tokeny przy użyciu innego wystawcy, aby można było utworzyć oddzielną integrację zabezpieczeń w rozwiązaniu Snowflake z unikatowym mapowaniem oświadczeń.
a. Kliknij pozycję Manifest.
b. Znajdź atrybutrequestedAccessTokenVersioni ustaw wartość na "2".- Po
requestedAccessTokenVersionustawieniu wartości "2" token dostępu będzie miał wystawcę formatu:https://login.microsoftonline.com/<Tenant-ID>/v2.0 - Po
requestedAccessTokenVersionustawieniu wartości "1" token dostępu będzie miał wystawcę formatu:https://sts.windows.net/<tenant-ID>/
c. Kliknij przycisk Zapisz.
- Po
B. Tworzenie klienta OAuth w identyfikatorze Entra firmy Microsoft
- Przejdź do witryny Microsoft Azure Portal i uwierzytelnij się.
- Przejdź do usługi Azure Active Directory.
- Kliknij pozycję Rejestracje aplikacji.
- Kliknij pozycję Nowa rejestracja.
- Wprowadź nazwę klienta, na przykład "Snowflake OAuth Client".
- Sprawdź, czy obsługiwane typy kont są ustawione na pojedynczą dzierżawę.
- Kliknij pozycję Zarejestruj.
- W sekcji Przegląd skopiuj wartość
ClientIDz pola Identyfikator aplikacji (klienta). Będzie to znane w<OAUTH_CLIENT_ID>poniższych krokach. - Kliknij pozycję Certyfikaty i wpisy tajne , a następnie pozycję Nowy klucz tajny klienta.
- Dodaj opis wpisu tajnego.
- W celach testowych wybierz długotrwałe wpisy tajne, ale w obszarze Produkcja należy przestrzegać niezbędnych zasad zabezpieczeń.
- Kliknij przycisk Dodaj. Skopiuj wpis tajny. Będzie to znane w
<OAUTH_CLIENT_SECRET>poniższych krokach. - W przypadku delegowanego uwierzytelniania:
a. Kliknij pozycję Zarządzaj uprawnieniami interfejsu>API.
b. Kliknij pozycję Dodaj uprawnienie.
c. Kliknij pozycję Moje interfejsy API.
d. Kliknij zasób Snowflake OAuth , który został utworzony w temacie Konfigurowanie zasobu Oauth w usłudze Microsoft Entra ID
e. Kliknij pole Uprawnienia delegowane .
f. Sprawdź uprawnienia powiązane z zakresami zdefiniowanymi ręcznie w aplikacji, które mają zostać przyznane temu klientowi.
g. Kliknij pozycję Dodaj uprawnienia.
h. Kliknij przycisk Udziel zgody administratora , aby udzielić uprawnień klientowi. Należy pamiętać, że w celach testowych uprawnienia są konfigurowane w ten sposób. Jednak w środowisku produkcyjnym przyznanie uprawnień w ten sposób nie jest zalecane.
punkt i. Kliknij przycisk Tak.
j. Kliknij pozycję Zarządzaj —> Uwierzytelnianie, dodaj platformę — > Sieć Web i wprowadź identyfikator URI przekierowania.
https://global.consent.azure-apim.net/redirect/snowflakev2
OR
- W przypadku uwierzytelniania jednostki usługi:
a. Kliknij pozycję Zarządzaj uprawnieniami interfejsu>API.
b. Kliknij pozycję Dodaj uprawnienie.
c. Kliknij pozycję Moje interfejsy API.
d. Kliknij zasób Snowflake OAuth , który został utworzony w temacie Konfigurowanie zasobu Oauth w usłudze Microsoft Entra ID .
e. Kliknij pole Uprawnienia aplikacji .
f. Sprawdź uprawnienie związane z rolami zdefiniowanymi ręcznie w manifeście aplikacji, które mają zostać przyznane temu klientowi.
g. Kliknij pozycję Dodaj uprawnienia.
h. Kliknij przycisk Udziel zgody administratora , aby udzielić uprawnień klientowi. Należy pamiętać, że w celach testowych uprawnienia są konfigurowane w ten sposób. Jednak w środowisku produkcyjnym przyznanie uprawnień w ten sposób nie jest zalecane.
punkt i. Kliknij przycisk Tak.
C. Zbieranie informacji o usłudze Azure AD dla rozwiązania Snowflake
- Przejdź do witryny Microsoft Azure Portal i uwierzytelnij się.
- Przejdź do usługi Azure Active Directory.
- Kliknij pozycję Rejestracje aplikacji.
- Kliknij zasób Snowflake OAuth, który został utworzony w temacie Konfigurowanie zasobu Oauth w usłudze Microsoft Entra ID .
- Kliknij pozycję Punkty końcowe w interfejsie Przegląd.
- Po prawej stronie skopiuj punkt końcowy tokenu OAuth 2.0 (wersja 2) i zanotuj adresy URL metadanych programu OpenID Connect i metadanych programu Federation Connect.
- Punkt końcowy tokenu OAuth 2.0 (wersja 2) będzie znany jako
<AZURE_AD_OAUTH_TOKEN_ENDPOINT>w poniższych krokach konfiguracji. Punkt końcowy powinien być podobny dohttps://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token. - W przypadku metadanych OpenID Connect otwórz je w nowym oknie przeglądarki.
-
jwks_uriZnajdź parametr i skopiuj jego wartość. - Ta wartość parametru będzie znana jako w
<AZURE_AD_JWS_KEY_ENDPOINT>poniższych krokach konfiguracji. Punkt końcowy powinien być podobny dohttps://login.microsoftonline.com/<tenant-id>/discovery/v2.0/keys.
-
- W dokumencie Metadane federacji otwórz adres URL w nowym oknie przeglądarki.
- Znajdź parametr w elemecie
"entityID"XML Root Elementi skopiuj jego wartość. - Ta wartość parametru będzie znana jako w
<AZURE_AD_ISSUER>poniższych krokach konfiguracji. Wartość entityID powinna być podobna dohttps://sts.windows.net/<tenant-id>/.
- Znajdź parametr w elemecie
D. Weryfikowanie konfiguracji autoryzacji entra
Zaleca się przetestowanie konfiguracji w tej chwili. Użyj poniższego narzędzia curl i sprawdź, czy Entra wystawia token przy użyciu dowolnego narzędzia do testowania interfejsu API, takiego jak bezsenność lub inne.
- Delegowane uwierzytelnianie: (opcjonalnie)
Aby uzyskać kod, należy wykonać poprzedni krok. Ten dokument można wykonać
curl --request POST --url https://login.microsoftonline.com/<TENANT_ID>/oauth2/token --header 'Content-Type: multipart/form-data' --form client_id=<AAD_CLIENT_ID> --form client_secret=< AAD_CLIENT_SECRET> --form resource=< AAD_RESOURCE_ID> --formgrant_type=authorization_code --form code=<CODE_GENERATED_ABOVE> --form redirect_uri=https://localhostUwaga: dodaj identyfikator URI przekierowania w aplikacji klienckiej usługi AAD.
OR
Uwierzytelnianie jednostki usługi:
curl -X POST -H "Content-Type: application/x-www-form-urlencoded;charset=UTF-8" \ --data-urlencode "client_id=client_id from above B.8" \ --data-urlencode "client_secret=<Secret from above B.12>" \ --data-urlencode "grant_type=client_credentials" \ --data-urlencode "scope=api://<Appl_URI_ID>/.default" \'https://login.microsoftonline.com/<tenant_id>/oauth2/v2.0/token'
Aby zweryfikować token, wykonaj poniższe polecenie w aplikacji Snowflake:
select system$verify_external_oauth_token(‘<token>’);
E. Tworzenie integracji zabezpieczeń z odbiorcami
external_oauth_audience_list Parametr integracji zabezpieczeń musi być zgodny z identyfikatorem URI identyfikatora aplikacji określonym podczas konfigurowania identyfikatora Entra firmy Microsoft.
Delegowane uwierzytelnianie:
create security integration external_oauth_azure_1 type = external_oauth enabled = true external_oauth_type = azure external_oauth_issuer = '<AZURE_AD_ISSUER>' external_oauth_jws_keys_url = '<AZURE_AD_JWS_KEY_ENDPOINT>' external_oauth_audience_list = ('<SNOWFLAKE_APPLICATION_ID_URI>') external_oauth_token_user_mapping_claim = ‘upn’ external_oauth_snowflake_user_mapping_attribute = 'login_name or email address';
Jeśli integracja z zabezpieczeniami dla usługi Azure AD jest już skonfigurowana, użyj:
alter security integration external_oauth_azure_1 set external_oauth_token_user_mapping_claim = ('sub','upn');
W przypadku uwierzytelniania delegowanego użytkownik login_name Snowflake lub email_address powinien odpowiadać adresowi e-mail entra użytkownika, który uruchomi przepływ usługi Power Automate.
Przykład:
ALTER USER SNOWSQL_DELEGATE_USER
LOGIN_NAME = '<ENTRA-USERID>' or EMAIL_ADDRESS = ‘ENTRA-USERID’
DISPLAY_NAME = 'SnowSQL Delegated User'
COMMENT = 'A delegate user for SnowSQL client to be used for OAuth based connectivity';
OR
Uwierzytelnianie jednostki usługi:
create security integration external_oauth_azure_2 type = external_oauth enabled = true external_oauth_type = azure external_oauth_issuer = '<AZURE_AD_ISSUER>' external_oauth_jws_keys_url = '<AZURE_AD_JWS_KEY_ENDPOINT>' external_oauth_audience_list = ('<SNOWFLAKE_APPLICATION_ID_URI>') external_oauth_token_user_mapping_claim = ‘sub’ external_oauth_snowflake_user_mapping_attribute = 'login_name';
Kontynuuj poniżej, aby uzyskać tylko konfigurację uwierzytelniania jednostki usługi.
Utwórz użytkownika dla połączenia opartego na jednostce usługi:
Podwartości powinny być mapowane na użytkownika w aplikacji Snowflake, należy unikać używania kont z wysokimi uprawnieniamiAdmin, Orgadmin, Securityadmin.
CREATE OR REPLACE USER SNOWSQL_OAUTH_USER LOGIN_NAME = '<subvalue from decoded token>' DISPLAY_NAME = 'SnowSQL OAuth User' COMMENT = 'A system user for SnowSQL client to be used for OAuth based connectivity'; CREATE ROLE ANALYST; GRANT ROLE ANALYST TO USER SNOWSQL_OAUTH_USER;
F. Weryfikowanie dostępu snowflake [opcjonalnie]
Delegowane uwierzytelnianie
snowsql -a organization-locator -u 'user@sandbox.onmicrosoft.com' --rolename <rolename> --authenticator oauth --token "<token-value>"
OR
Uwierzytelnianie jednostki usługi
snowsql -a <snowflake-accountname> -u ‘sub-value’ -r <snowflake-role from A.11.h above> –authenticator oauth –token <output from curl at step D>
Klienci korzystający z łącznika Snowflake [PRZESTARZAŁE]
Dotyczy: wszystkie regiony
Aby przeprowadzić migrację ze starszego łącznika snowflake do nowego, wykonaj poniższe kroki.
Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.
Jeśli przepływ usługi Power Automate przy użyciu poprzednich łączników został skompilowany (teraz oznaczony jako przestarzały), należy skonfigurować nowe połączenie zgodnie z instrukcjami opisanymi w sekcji Kroki konfiguracji powyżej i zaktualizować istniejące przepływy, aby korzystać z nowego połączenia.
Akcja "Konwertuj wiersze zestawu wyników z tablicy na obiekty" również musi zostać porzucona, ponieważ ta funkcja jest teraz opakowana w "Sprawdź stan i pobierz wyniki".
Znane problemy i ograniczenia
Obecnie nie obsługujemy zduplikowanych kolumn po wykonaniu polecenia sprzężenia. Obejściem byłoby dodanie aliasów do zduplikowanych kolumn.
W tym miejscu wymieniono inne ograniczenia dotyczące tabel wirtualnych.
Tabele wirtualne są obsługiwane tylko w przypadku połączeń utworzonych przy użyciu uwierzytelniania "Jednostka usługi".
W przypadku korzystania z uwierzytelniania jednostki usługi użytkownik musi mieć dostęp do odczytu do tabeli information_schema.columns .
Nie można utworzyć połączeń płatka śniegu bezpośrednio w aplikacjach kanwy, informacjach o błędach i krokach, które są potrzebne do rozwiązania problemu, są następujące:
- Błąd pokaże, czy połączenie usługi Snowflake zostało utworzone bezpośrednio w aplikacji kanwy, jak pokazano na poniższym zrzucie ekranu


- Zamiast dodawać łącznik bezpośrednio w aplikacji Kanwy, utwórz połączenie jednostki usługi (nie delegowane) spoza aplikacji Kanwy
- Użyj połączenia Snowflake utworzonego powyżej i utwórz
z tabelą wirtualną - Następnie można załadować tabelę wirtualną w aplikacji Kanwy, a kompilacja z aplikacji Kanwy może kontynuować

- Tabela ANIMALS powyżej jest tabelą wirtualną utworzoną przy użyciu połączenia snowflake, jak wspomniano powyżej
- Błąd pokaże, czy połączenie usługi Snowflake zostało utworzone bezpośrednio w aplikacji kanwy, jak pokazano na poniższym zrzucie ekranu
Uwaga / Notatka
- Użytkownicy zawsze muszą upewnić się, że wszystkie szczegóły konta usługi Snowflake (magazyn, rola, schemat, baza danych) znajdują się w tej samej literze co konto Snowflake podczas konfigurowania akcji połączenia/przepływu.
- W ramach kroku weryfikacji zarówno dla połączeń delegowanych, jak i opartych na jednostce usługi utwórz przepływ usługi Power Automate, aby zweryfikować połączenie.
Ogólne limity
| Name | Wartość |
|---|---|
| Maksymalna liczba żądań przetwarzanych przez łącznik jednocześnie | 50 |
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Jednostka usługi (aplikacja Microsoft Entra ID) | Użyj aplikacji Microsoft Entra ID, aby uzyskać dostęp do bazy danych Snowflake. | Wszystkie regiony | Udostępnialne |
| Uwierzytelnianie delegowane jednostki usługi (aplikacja Microsoft Entra ID) | Użyj aplikacji Microsoft Entra ID, aby uzyskać dostęp do bazy danych Snowflake. | Wszystkie regiony | Udostępnialne |
| 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ć |
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 Snowflake.
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 | |
| Adres URL zasobu | ciąg | Adres URL odbiorców usługi Snowflake OAuth (adres URL zasobu) | Prawda |
| Snowflake SaaS URL | ciąg | Adres URL usługi Snowflake nie zawiera prefiksu HTTPS (np. fnpuupu-in12345.snowflakecomputing.com) | Prawda |
| Baza danych snowflake | ciąg | Określ bazę danych do nawiązania połączenia | Prawda |
| Nazwa magazynu | ciąg | Magazyn Snowflake w celu nawiązania połączenia z | Prawda |
| Role | ciąg | Rola snowflake do nawiązania połączenia jako | Prawda |
| Schema | ciąg | Schemat snowflake do nawiązania połączenia z | Prawda |
Uwierzytelnianie delegowane jednostki usługi (aplikacja Microsoft Entra ID)
Identyfikator uwierzytelniania: oauthSPUserDelegated
Dotyczy: wszystkie regiony
Użyj aplikacji Microsoft Entra ID, aby uzyskać dostęp do bazy danych Snowflake.
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 |
|---|---|---|---|
| ID klienta | ciąg | Identyfikator klienta usługi Snowflake OAuth | Prawda |
| Tajemnica klienta | securestring | Snowflake OAuth Client Secret | Prawda |
| Adres URL zasobu | ciąg | Adres URL odbiorców usługi Snowflake OAuth (adres URL zasobu) | 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 zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Jest to fikcyjny symbol zastępczy potrzebny na czas ze względu na usterkę widżetu połączenia interfejsu użytkownika mcS. Wszelkie zmiany uwierzytelniania powinny zostać wprowadzone w parametrach connectionParameterSets | ciąg | Jest to fikcyjny symbol zastępczy potrzebny na czas ze względu na usterkę widżetu połączenia interfejsu użytkownika mcS. Wszelkie zmiany uwierzytelniania powinny zostać wprowadzone w parametrach connectionParameterSets |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 900 | 60 sekund |
Akcje
| Anulowanie wykonywania instrukcji |
Anulowanie wykonywania instrukcji |
| Przesyłanie instrukcji SQL na potrzeby wykonywania |
Przesyłanie instrukcji SQL na potrzeby wykonywania |
| Sprawdzanie stanu i uzyskiwanie wyników |
Sprawdź stan wykonania instrukcji i pobierz wyniki |
Anulowanie wykonywania instrukcji
Anulowanie wykonywania instrukcji
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Instance
|
Instance | True | string |
Identyfikator URI wystąpienia snowflake (bez https://) |
|
dojście instrukcji
|
statementHandle | True | string |
dojście instrukcji |
|
Identyfikator żądania
|
requestId | string |
Identyfikator żądania |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
kod
|
code | string |
kod |
|
sqlState
|
sqlState | string |
sqlState |
|
komunikat
|
message | string |
komunikat |
|
statementHandle
|
statementHandle | string |
statementHandle |
|
statementStatusUrl
|
statementStatusUrl | string |
statementStatusUrl |
Przesyłanie instrukcji SQL na potrzeby wykonywania
Przesyłanie instrukcji SQL na potrzeby wykonywania
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Instance
|
Instance | True | string |
Identyfikator URI wystąpienia snowflake (bez https://) |
|
Identyfikator żądania
|
requestId | string |
Identyfikator żądania |
|
|
Asynchronous
|
asyncexecution | boolean |
Wskazuje, czy zapytanie powinno być wykonywane asynchronicznie |
|
|
Zanullowalny
|
nullable | boolean |
Jeśli wartość null ma wartość false, wartości null zostaną zastąpione ciągiem |
|
|
instrukcja
|
statement | string |
Instrukcja SQL do wykonania — partie instrukcji nie są jeszcze obsługiwane |
|
|
przerwa czasowa
|
timeout | integer |
Liczba sekund przed przekroczeniem limitu czasu |
|
|
baza danych
|
database | string |
baza danych |
|
|
schemat
|
schema | string |
schemat |
|
|
warehouse
|
warehouse | string |
warehouse |
|
|
rola
|
role | string |
rola |
|
|
timezone
|
timezone | string |
Strefa czasowa do użycia podczas wykonywania instrukcji . |
|
|
tag zapytania
|
query_tag | string |
Tag zapytania, który chcesz skojarzyć z instrukcją SQL. |
|
|
format danych wyjściowych binarnych
|
binary_output_format | string |
Format danych wyjściowych dla wartości binarnych. |
|
|
format danych wyjściowych daty
|
date_output_format | string |
Format danych wyjściowych dla wartości DATE. |
|
|
format danych wyjściowych czasu
|
time_output_format | string |
Format danych wyjściowych dla wartości TIME. |
|
|
format danych wyjściowych znacznika czasu
|
timestamp_output_format | string |
Format danych wyjściowych dla wartości TIMESTAMP. |
|
|
format wyjściowy znacznika czasu ltz
|
timestamp_ltz_output_format | string |
Format danych wyjściowych dla wartości TIMESTAMP_LTZ. |
|
|
timestamp_ntz_output_format
|
timestamp_ntz_output_format | string |
Format danych wyjściowych dla wartości TIMESTAMP_NTZ. |
|
|
format danych wyjściowych znacznika czasu
|
timestamp_tz_output_format | string |
Format danych wyjściowych dla wartości TIMESTAMP_TZ. |
|
|
liczba instrukcji z wieloma instrukcjami
|
MULTI_STATEMENT_COUNT | integer |
Liczba instrukcji do wykonania podczas korzystania z funkcji wielu instrukcji. Wartość 0 oznacza zmienną liczbę instrukcji. Liczby ujemne są niedozwolone. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Partitions
|
Partitions | array of object |
Partitions |
|
RowCount
|
Partitions.RowCount | integer |
RowCount |
|
UncompressedSize
|
Partitions.UncompressedSize | integer |
UncompressedSize |
|
Skompresowany rozmiar
|
Partitions.CompressedSize | integer |
Skompresowany rozmiar |
|
Schema
|
Schema | array of object |
Schema |
|
nazwa
|
Schema.name | string |
nazwa |
|
baza danych
|
Schema.database | string |
baza danych |
|
schemat
|
Schema.schema | string |
schemat |
|
tabela
|
Schema.table | string |
tabela |
|
dopuszczający wartość null
|
Schema.nullable | boolean |
dopuszczający wartość null |
|
precyzja
|
Schema.precision | integer |
precyzja |
|
skala
|
Schema.scale | integer |
skala |
|
byteLength
|
Schema.byteLength | integer |
byteLength |
|
sortowanie
|
Schema.collation | string |
sortowanie |
|
length
|
Schema.length | integer |
length |
|
typ
|
Schema.type | string |
typ |
|
Dane
|
Data | array of |
Dane |
|
Wiersze
|
Metadata.Rows | integer |
Wiersze |
|
Format
|
Metadata.Format | string |
Format |
|
Code
|
Metadata.Code | string |
Code |
|
StatementStatusUrl
|
Metadata.StatementStatusUrl | string |
StatementStatusUrl |
|
Identyfikator żądania
|
Metadata.RequestId | string |
Identyfikator żądania |
|
SqlState
|
Metadata.SqlState | string |
SqlState |
|
StatementHandle
|
Metadata.StatementHandle | string |
StatementHandle |
|
StatementHandles
|
Metadata.StatementHandles | array of string |
StatementHandles z wykonywania wielu instrukcji |
|
Utworzony
|
Metadata.CreatedOn | string |
Utworzony |
Sprawdzanie stanu i uzyskiwanie wyników
Sprawdź stan wykonania instrukcji i pobierz wyniki
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Instance
|
Instance | True | string |
Identyfikator URI wystąpienia snowflake (bez https://) |
|
dojście instrukcji
|
statementHandle | True | string |
dojście instrukcji |
|
Identyfikator żądania
|
requestId | string |
Identyfikator żądania |
|
|
partycja
|
partition | integer |
partycja |
|
|
nazwa
|
name | string |
nazwa |
|
|
baza danych
|
database | string |
baza danych |
|
|
schemat
|
schema | string |
schemat |
|
|
tabela
|
table | string |
tabela |
|
|
dopuszczający wartość null
|
nullable | boolean |
dopuszczający wartość null |
|
|
precyzja
|
precision | integer |
precyzja |
|
|
skala
|
scale | integer |
skala |
|
|
byteLength
|
byteLength | integer |
byteLength |
|
|
sortowanie
|
collation | string |
sortowanie |
|
|
length
|
length | integer |
length |
|
|
typ
|
type | string |
typ |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Partitions
|
Partitions | array of object |
Partitions |
|
RowCount
|
Partitions.RowCount | integer |
RowCount |
|
UncompressedSize
|
Partitions.UncompressedSize | integer |
UncompressedSize |
|
Skompresowany rozmiar
|
Partitions.CompressedSize | integer |
Skompresowany rozmiar |
|
Schema
|
Schema | array of object |
Schema |
|
nazwa
|
Schema.name | string |
nazwa |
|
baza danych
|
Schema.database | string |
baza danych |
|
schemat
|
Schema.schema | string |
schemat |
|
tabela
|
Schema.table | string |
tabela |
|
precyzja
|
Schema.precision | integer |
precyzja |
|
skala
|
Schema.scale | integer |
skala |
|
typ
|
Schema.type | string |
typ |
|
dopuszczający wartość null
|
Schema.nullable | boolean |
dopuszczający wartość null |
|
byteLength
|
Schema.byteLength | integer |
byteLength |
|
sortowanie
|
Schema.collation | string |
sortowanie |
|
length
|
Schema.length | integer |
length |
|
Dane
|
Data | array of |
Dane |
|
StatementHandle
|
StatementHandle | string |
StatementHandle |
|
Wiersze
|
Metadata.Rows | integer |
Wiersze |
|
Format
|
Metadata.Format | string |
Format |
|
Code
|
Metadata.Code | string |
Code |
|
StatementStatusUrl
|
Metadata.StatementStatusUrl | string |
StatementStatusUrl |
|
Identyfikator żądania
|
Metadata.RequestId | string |
Identyfikator żądania |
|
SqlState
|
Metadata.SqlState | string |
SqlState |
|
Utworzony
|
Metadata.CreatedOn | string |
Utworzony |
|
StatementHandles
|
Metadata.StatementHandles | array of string |
StatementHandles z wykonywania wielu instrukcji |