Udostępnij przez


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
Email 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

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.

  1. Dowiedz się, jak skonfigurować usługę Azure Private Link i aplikację Snowflake
  2. 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

  1. Serwer autoryzacji może udzielić klientowi OAuth tokenu dostępu w imieniu użytkownika, o którym mowa DELEGATED BASED AUTH.
  2. Serwer autoryzacji może udzielić klientowi OAuth tokenu dostępu dla samego klienta OAuth, o nazwie SP BASED AUTH.
  3. 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/snowflakev2identyfikator URI przekierowania
  4. Należy utworzyć integrację zabezpieczeń z odbiorcami.
  5. W przypadku uwierzytelniania delegowanego, external_oauth_token_user_mapping_claim = 'upn'
  6. W przypadku uwierzytelniania opartego na sp, external_oauth_token_user_mapping_claim = 'sub'
  7. 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.
    Lista zablokowanych
  8. Upewnij się, że login_name role 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.
    Szczegóły użytkownika

Kroki konfiguracji

A. Konfigurowanie zasobu OAuth w identyfikatorze Entra firmy Microsoft

  1. Przejdź do witryny Microsoft Azure Portal i uwierzytelnij się.
  2. Przejdź do pozycji Microsoft Entra ID.
  3. Kliknij pozycję Rejestracje aplikacji.
  4. Kliknij pozycję Nowa rejestracja.
  5. Wprowadź wartość "Zasób OAuth snowflake" lub podobną wartość jako nazwę.
  6. Sprawdź, czy obsługiwane typy kont są ustawione na pojedynczą dzierżawę.
  7. Kliknij pozycję Zarejestruj.
  8. Kliknij pozycję Uwidaczniaj interfejs API.
  9. 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>
  10. W przypadku delegowanego uwierzytelniania (zrzuty ekranu tutaj):
    1. Kliknij pozycję Dodaj zakres, aby dodać zakres reprezentujący rolę Snowflake.
    2. Wybierz, kto może wyrazić zgodę.
    3. Dodaj opis.
    4. Kliknij pozycję Dodaj zakres, aby zapisać.
      Przykład: session:scope:analyst

      OR

  11. 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:
    1. Kliknij pozycję Manifest.

    2. appRoles Znajdź element .

    3. 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).

    4. 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 jak ACCOUNTADMIN, SECURITYADMIN lub ORGADMIN.

       "appRoles":[
           {
               "allowedMemberTypes": [ "Application" ],
               "description": "Analyst.",
               "displayName": "Analyst",
               "id": "3ea51f40-2ad7-4e79-aa18-12c45156dc6a",
               "isEnabled": true,
               "lang": null,
               "origin": "Application",
               "value": "session:role:analyst"
           }
       ]
      
    5. Kliknij pozycję Zapisz

  12. 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ź atrybut requestedAccessTokenVersion i ustaw wartość na "2".
    • Po requestedAccessTokenVersion ustawieniu wartości "2" token dostępu będzie miał wystawcę formatu: https://login.microsoftonline.com/<Tenant-ID>/v2.0
    • Po requestedAccessTokenVersion ustawieniu wartości "1" token dostępu będzie miał wystawcę formatu: https://sts.windows.net/<tenant-ID>/
      c. Kliknij przycisk Zapisz.

B. Tworzenie klienta OAuth w identyfikatorze Entra firmy Microsoft

  1. Przejdź do witryny Microsoft Azure Portal i uwierzytelnij się.
  2. Przejdź do usługi Azure Active Directory.
  3. Kliknij pozycję Rejestracje aplikacji.
  4. Kliknij pozycję Nowa rejestracja.
  5. Wprowadź nazwę klienta, na przykład "Snowflake OAuth Client".
  6. Sprawdź, czy obsługiwane typy kont są ustawione na pojedynczą dzierżawę.
  7. Kliknij pozycję Zarejestruj.
  8. W sekcji Przegląd skopiuj wartość ClientID z pola Identyfikator aplikacji (klienta). Będzie to znane w <OAUTH_CLIENT_ID> poniższych krokach.
  9. Kliknij pozycję Certyfikaty i wpisy tajne , a następnie pozycję Nowy klucz tajny klienta.
  10. Dodaj opis wpisu tajnego.
  11. W celach testowych wybierz długotrwałe wpisy tajne, ale w obszarze Produkcja należy przestrzegać niezbędnych zasad zabezpieczeń.
  12. Kliknij przycisk Dodaj. Skopiuj wpis tajny. Będzie to znane w <OAUTH_CLIENT_SECRET> poniższych krokach.
  13. 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

  14. 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

  1. Przejdź do witryny Microsoft Azure Portal i uwierzytelnij się.
  2. Przejdź do usługi Azure Active Directory.
  3. Kliknij pozycję Rejestracje aplikacji.
  4. Kliknij zasób Snowflake OAuth, który został utworzony w temacie Konfigurowanie zasobu Oauth w usłudze Microsoft Entra ID .
  5. Kliknij pozycję Punkty końcowe w interfejsie Przegląd.
  6. 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 do https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token.
  • W przypadku metadanych OpenID Connect otwórz je w nowym oknie przeglądarki.
    • jwks_uri Znajdź 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 do https://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 Element i skopiuj jego wartość.
    • Ta wartość parametru będzie znana jako w <AZURE_AD_ISSUER> poniższych krokach konfiguracji. Wartość entityID powinna być podobna do https://sts.windows.net/<tenant-id>/.

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://localhost
      
    • Uwaga: 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

  1. Obecnie nie obsługujemy zduplikowanych kolumn po wykonaniu polecenia sprzężenia. Obejściem byłoby dodanie aliasów do zduplikowanych kolumn.

  2. W tym miejscu wymieniono inne ograniczenia dotyczące tabel wirtualnych.

  3. Tabele wirtualne są obsługiwane tylko w przypadku połączeń utworzonych przy użyciu uwierzytelniania "Jednostka usługi".

  4. W przypadku korzystania z uwierzytelniania jednostki usługi użytkownik musi mieć dostęp do odczytu do tabeli information_schema.columns .

  5. 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:

    1. 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: Tworzenie błędu połączenia
    2. Zamiast dodawać łącznik bezpośrednio w aplikacji Kanwy, utwórz połączenie jednostki usługi (nie delegowane) spoza aplikacji Kanwy
    3. Użyj połączenia Snowflake utworzonego powyżej i utwórz błąd połączenia z tabelą wirtualną
    4. Następnie można załadować tabelę wirtualną w aplikacji Kanwy, a kompilacja z aplikacji Kanwy może kontynuować błąd połączenia
    5. Tabela ANIMALS powyżej jest tabelą wirtualną utworzoną przy użyciu połączenia snowflake, jak wspomniano powyżej

Uwaga / Notatka

  1. 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.
  2. 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