Aracılığıyla paylaş


Snowflake

Snowflake Connector, sanal tablolarda tuval uygulamaları oluşturmanıza ve Snowflake verilerini ortaya çıkararak geleneksel çözümlere kıyasla daha hızlı veri işleme ve analiz olanağı sağlar.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet Class Bölgeler
Copilot Studio Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Logic Apps Standart Aşağıdakiler dışında tüm Logic Apps bölgeleri :
     - Azure Kamu bölgeleri
     - Azure Çin bölgeleri
     - ABD Savunma Bakanlığı (DoD)
Power Apps Premium Aşağıdakiler dışında tüm Power Apps bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Power Automate Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
İletişim
İsim Snowflake Desteği
URL https://www.snowflake.com/support
E-posta support@snowflake.com
Bağlayıcı Meta Verileri
Publisher Snowflake
Web sitesi https://www.snowflake.com
Gizlilik ilkesi https://www.snowflake.com/privacy-policy
Kategoriler Veri; Pazarlama

Bağlayıcı derinlemesine

Bu makalede Snowflake bağlayıcısının özellikleri ve eylemleri açıklanmaktadır.

Power Automate için Desteklenen Özellikler

  • Kullanıcılar, Snowflake bağlantısıyla özel SQL deyimlerini yürütmek ve sonuçları geri almak için akışlar oluşturabilir ve eylemler ekleyebilir.

Power Apps için Desteklenen Özellikler

Logic Apps için Desteklenen Özellikler

  • Kullanıcılar, Snowflake bağlantısıyla özel SQL deyimlerini yürütmek ve sonuçları geri almak için akışlar oluşturabilir ve eylemler ekleyebilir.

Sanal Ağ Desteği

Power Platform için Azure Sanal Ağ desteği sayesinde kullanıcılar, power platformlarını genel İnternet üzerinden kullanıma açmadan sanal ağlarındaki kaynaklarla tümleştirebilir. Sanal Ağa bağlanmak için lütfen aşağıda belirtilen her iki adımı da izlediğinden emin olun.

  1. Azure Özel Bağlantı ve Snowflake kurulumu hakkında bilgi edinin
  2. Power Platform için Sanal Ağ desteğini ayarlamayı öğrenin

Sanal ağ hakkında daha fazla bilgi edinmek için lütfen Sanal Ağ desteğine genel bakış bölümüne bakın.

Önkoşullar

  • Kullanıcıların dış yetkilendirme için Microsoft Entra Kimliğine sahip olması gerekir. PowerApps yetkilendirme akışı Hizmet Sorumlusu'na sahip olur ve Power Automate hem Service-Principal hem de kullanıcı adına akışları destekler.
  • Kullanıcıların premium Power Apps lisansı olmalıdır.
  • Kullanıcıların Snowflake hesabı olmalıdır.

Snowflake bağlayıcısını kullanma yapılandırmasıyla ilgili olarak göz önünde bulundurulması gereken birkaç şey

  1. Yetkilendirme sunucusu, OAuth istemcisine kullanıcı adına , olarak adlandırılan DELEGATED BASED AUTHbir erişim belirteci verebilir.
  2. Yetkilendirme sunucusu, OAuth istemcisine OAuth istemcisi için olarak SP BASED AUTHadlandırılan bir erişim belirteci verebilir.
  3. Oauth istemcisi için, temsilci tabanlı AUTHiçin yeniden yönlendirme URI'sini (Web tabanlı) eklediğinizden emin olun.
    Yeniden Yönlendirme URI'si - https://global.consent.azure-apim.net/redirect/snowflakev2Yeniden Yönlendirme URI'si
  4. Hedef kitlelerle bir güvenlik tümleştirmesi oluşturulmalıdır.
  5. Temsilci tabanlı kimlik doğrulaması için, external_oauth_token_user_mapping_claim = 'upn'
  6. SP tabanlı kimlik doğrulaması için, external_oauth_token_user_mapping_claim = 'sub'
  7. Güvenlik tümleştirmesini oluştururken oluşturulan tümleştirmeyi açıklayın ve Snowflake kullanıcısına verilen rolün engellenenler listesinde olup olmadığını denetleyin. Engellenenler listesindeyse, engellenenler listesindeki kullanıcının rolünü değiştirin veya kaldırın.
    EngellenenLer Listesi
  8. login_name Snowflake hesabında ve rollerinin doğru ayarlandığından emin olun. Bu, Yönetici Sekmesi > Kullanıcıları ve Rolleri > Kullanıcı seçin ve Kullanıcı ayrıntılarını düzenleyin aracılığıyla denetlenebilir.
    Kullanıcı Ayrıntıları

Yapılandırma Adımları

A. Microsoft Entra Id'de OAuth kaynağını yapılandırma

  1. Microsoft Azure Portalı'na gidin ve kimlik doğrulaması yapın.
  2. Microsoft Entra Id'ye gidin.
  3. Uygulama Kayıtları'ne tıklayın.
  4. Yeni Kayıt'a tıklayın.
  5. 'Snowflake OAuth Kaynağı' veya Ad olarak benzer bir değer girin.
  6. Desteklenen hesap türlerininTek Kiracı olarak ayarlandığını doğrulayın.
  7. Kaydet’e tıklayın.
  8. API'yi kullanıma sunma'ya tıklayın.
  9. Uygulama Kimliği URI'sini eklemek için Uygulama Kimliği URI'sinin yanındaki bağlantıya tıklayın. Uygulama Kimliği URI'si biçiminde olacaktır Application ID URI <api://9xxxxxxxxxxxxxxxxxx>
  10. Temsilci Kimlik Doğrulaması için (ekran görüntüleri burada):
    1. Snowflake rolünü temsil eden bir kapsam eklemek için Kapsam Ekle'ye tıklayın.
    2. Kimlerin onay verebileceğini seçin.
    3. Bir açıklama ekleyin.
    4. Kaydetmek için Kapsam Ekle'ye tıklayın.
      Örnek: session:scope:analyst

      OR

  11. Hizmet Sorumlusu Kimlik Doğrulaması için (ekran görüntüleri burada):
    Programlı istemcinin kendisi için erişim belirteci istediği OAuth akışları için Rol olarak Snowflake Rolü eklemek için:
    1. Bildirim'e tıklayın.

    2. appRoles öğesini bulun.

    3. Aşağıdaki ayarlarla bir Uygulama Rolü girin; Snowflake rolü bir ambara erişimi olan rol ve şemada kullanım ayrıcalıkları olmalıdır (bildirim valeleriyle ilgili ayrıntılar için buraya bakın).

    4. Aşağıdaki örnek tanıma bakın:

      Uygulama Rolü aşağıdaki gibi bildirimde bulunur. veya ORGADMINgibi ACCOUNTADMINSECURITYADMIN yüksek ayrıcalıklı rolleri kullanmaktan kaçının.

       "appRoles":[
           {
               "allowedMemberTypes": [ "Application" ],
               "description": "Analyst.",
               "displayName": "Analyst",
               "id": "3ea51f40-2ad7-4e79-aa18-12c45156dc6a",
               "isEnabled": true,
               "lang": null,
               "origin": "Application",
               "value": "session:role:analyst"
           }
       ]
      
    5. Kaydet'e tıklayın

  12. İsteğe bağlı olarak, Snowflake'de PowerBI gibi başka bir Microsoft ürünüyle ve farklı bir talep eşlemesiyle bir güvenlik tümleştirmesi kullanılıyorsa bildirimin değiştirilmesi gerekir. Benzersiz talep eşlemesi ile Snowflake'de ayrı bir güvenlik tümleştirmesi oluşturulabilmesi için bildirimin farklı bir veren kullanarak belirteçleri yayması gerekir.
    a. Bildirim'e tıklayın.
    b. özniteliğini requestedAccessTokenVersion bulun ve değerini "2" olarak ayarlayın.
    • requestedAccessTokenVersion"2" olarak ayarlandığında, Erişim Belirteci bir biçim verene sahip olur:https://login.microsoftonline.com/<Tenant-ID>/v2.0
    • requestedAccessTokenVersion"1" olarak ayarlandığında, Erişim Belirteci bir biçim verene sahip olur:https://sts.windows.net/<tenant-ID>/
      c. Kaydet'e tıklayın.

B. Microsoft Entra Id'de OAuth istemcisi oluşturma

  1. Microsoft Azure Portalı'na gidin ve kimlik doğrulaması yapın.
  2. Azure Active Directory'ye gidin.
  3. Uygulama Kayıtları'ne tıklayın.
  4. Yeni Kayıt'a tıklayın.
  5. İstemci için 'Snowflake OAuth İstemcisi' gibi bir ad girin.
  6. Desteklenen hesap türlerinin Tek Kiracı olarak ayarlandığını doğrulayın.
  7. Kaydet'e tıklayın.
  8. Genel Bakış bölümünde, Uygulama (istemci) Kimliği alanından öğesini kopyalayınClientID. Bu, aşağıdaki adımlarda olarak <OAUTH_CLIENT_ID> bilinir.
  9. Sertifikalar ve gizli diziler'e ve ardından Yeni istemci gizli dizisi'ne tıklayın.
  10. Gizli dizinin açıklamasını ekleyin.
  11. Test amacıyla uzun ömürlü gizli dizileri seçin, ancak Üretim için gerekli güvenlik ilkelerini izleyin.
  12. Ekle'yi tıklatın. Gizli diziyi kopyalayın. Bu, aşağıdaki adımlarda olarak <OAUTH_CLIENT_SECRET> bilinir.
  13. Temsilci Kimlik Doğrulaması için:
    a. Yönet ->API İzinleri'ne tıklayın.
    b. İzin Ekle'ye tıklayın.
    c. API'lerim'e tıklayın.
    d. Microsoft Entra Id'de Oauth Kaynağını Yapılandırma bölümünde oluşturulan Snowflake OAuth Kaynağına tıklayın
    e. Temsilci İzinleri kutusuna tıklayın.
    f. Bu istemciye verilmesini istediğiniz Uygulamada el ile tanımlanan Kapsamlarla ilgili İzin'i denetleyin.
    g. İzin Ekle'ye tıklayın.
    h. İstemciye izinleri vermek için Yönetici Onayı Ver düğmesine tıklayın. Test amacıyla izinlerin bu şekilde yapılandırıldığını unutmayın. Ancak, bir üretim ortamında bu şekilde izin verilmesi önerilmez.
    i. Evet seçeneğini tıklatın.
    j. Yönet -> Kimlik Doğrulama'ya tıklayın, platform ekleyin - > Web ve Yeniden Yönlendirme URI'lerinin
    https://global.consent.azure-apim.net/redirect/snowflakev2

    OR

  14. Hizmet Sorumlusu Kimlik Doğrulaması için:
    a. Yönet ->API İzinleri'ne tıklayın.
    b. İzin Ekle'ye tıklayın.
    c. API'lerim'e tıklayın.
    d. Microsoft Entra Id'de Oauth Kaynağını Yapılandırma bölümünde oluşturulan Snowflake OAuth Kaynağına tıklayın.
    e. Uygulama İzinleri kutusuna tıklayın.
    f. Bu istemciye verilmesini istediğiniz Uygulama Bildiriminde el ile tanımlanan Rollerle ilgili İzin'i denetleyin.
    g. İzin Ekle'ye tıklayın.
    h. İstemciye izinleri vermek için Yönetici Onayı Ver düğmesine tıklayın. Test amacıyla izinlerin bu şekilde yapılandırıldığını unutmayın. Ancak, bir üretim ortamında bu şekilde izin verilmesi önerilmez.
    i. Evet'e tıklayın.

C. Snowflake için Azure AD bilgilerini toplama

  1. Microsoft Azure Portalı'na gidin ve kimlik doğrulaması yapın.
  2. Azure Active Directory'ye gidin.
  3. Uygulama Kayıtları'ne tıklayın.
  4. Microsoft Entra Id'de Oauth Kaynağını Yapılandırma bölümünde oluşturulan Snowflake OAuth Kaynağına tıklayın.
  5. Genel Bakış arabiriminde Uç Noktalar'a tıklayın.
  6. Sağ tarafta , OAuth 2.0 belirteç uç noktasını (v2) kopyalayın ve OpenID Connect meta verileri ve Federasyon Bağlantısı meta verilerinin URL'lerini not edin.
  • Aşağıdaki yapılandırma adımlarında OAuth 2.0 belirteç uç noktası (v2) olarak <AZURE_AD_OAUTH_TOKEN_ENDPOINT> bilinir. Uç nokta ile https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/tokenbenzer olmalıdır.
  • OpenID Connect meta verileri için yeni bir tarayıcı penceresinde açın.
    • parametresini jwks_uri bulun ve değerini kopyalayın.
    • Bu parametre değeri, aşağıdaki yapılandırma adımlarında olarak <AZURE_AD_JWS_KEY_ENDPOINT> bilinir. Uç nokta ile https://login.microsoftonline.com/<tenant-id>/discovery/v2.0/keysbenzer olmalıdır.
  • Federasyon meta verileri belgesi için URL'yi yeni bir tarayıcı penceresinde açın.
    • içinde XML Root Element parametresini "entityID" bulun ve değerini kopyalayın.
    • Bu parametre değeri, aşağıdaki yapılandırma adımlarında olarak <AZURE_AD_ISSUER> bilinir. entityID değeri ile https://sts.windows.net/<tenant-id>/benzer olmalıdır.

D. Entra Yetkilendirme kurulumunu doğrulama

Yapılandırmanın şu anda test edilmesi önerilir, lütfen aşağıdaki curl'ı kullanın ve Entra'nın Uykusuzluk veya diğerleri gibi herhangi bir API test aracını kullanarak belirteç verilip vermediğini denetleyin.

  • Temsilci Kimlik Doğrulaması: (İsteğe bağlı)
    • Kodu almak için önceki bir adım yürütülmelidir, bu belge takip edilebilir

      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
      
    • Not: Lütfen AAD istemci uygulamasına yeniden yönlendirme URI'sini ekleyin.

OR

  • Hizmet Sorumlusu Kimlik Doğrulaması:

    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'
    

Belirteci doğrulamak için Snowflake'de aşağıdaki komutu yürütebilirsiniz:

select system$verify_external_oauth_token(‘<token>’);

E. Hedef kitlelerle güvenlik tümleştirmesi oluşturma

external_oauth_audience_list Güvenlik tümleştirmesinin parametresi, Microsoft Entra Kimliği yapılandırırken belirtilen Uygulama Kimliği URI'si ile eşleşmelidir.

  • Temsilci Kimlik Doğrulaması:

    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';
    

Azure AD için Güvenlik Tümleştirmesi zaten ayarlanmışsa şunu kullanın:

alter security integration external_oauth_azure_1 set external_oauth_token_user_mapping_claim = ('sub','upn');  

Temsilcili Kimlik Doğrulaması söz konusu olduğunda, Snowflake kullanıcısının login_name veya email_address Power Automate akışını çalıştıracak kullanıcının Entra e-postası ile eşleşmesi gerekir.

Örnek:

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

  • Hizmet Sorumlusu Kimlik Doğrulaması:

    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';
    

Yalnızca Hizmet Sorumlusu Kimlik Doğrulaması kurulumu için aşağıdan devam edin.

Hizmet Sorumlusu tabanlı bağlantı için kullanıcı oluşturma:

  • Alt değerin Snowflake'deki bir kullanıcıyla eşlenmesi gerekir. Accountadmin, Orgadmin, Securityadmin yüksek ayrıcalıklı hesapları kullanmaktan kaçının.

    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. Snowflake Erişimini Doğrulama [İsteğe bağlı]

  • Temsilci Kimlik Doğrulaması

    snowsql -a organization-locator -u 'user@sandbox.onmicrosoft.com' --rolename <rolename> --authenticator oauth --token "<token-value>"
    

OR

  • Hizmet Sorumlusu Kimlik Doğrulaması

    snowsql -a <snowflake-accountname> -u ‘sub-value’ -r <snowflake-role from A.11.h above> –authenticator oauth –token <output from curl at step D> 
    

Snowflake Bağlayıcısı kullanan müşteriler [KULLANIM DIŞI]

Geçerli: Tüm bölgeler

Eski bir Snowflake bağlayıcısından yenisine geçmek için lütfen aşağıdaki adımları izleyin.

Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.

Önceki bağlayıcıları kullanan bir Power Automate akışı oluşturulmuşsa (artık kullanım dışı olarak işaretlenmişse), yukarıdaki Yapılandırma Adımları altında belgelenen adımları izleyerek yeni bir bağlantının ayarlanması ve mevcut akışları yeni bağlantıyı kullanacak şekilde güncelleştirilmiş olması gerekir.

"Sonuç kümesi satırlarını diziden nesnelere dönüştür" eyleminin de bırakılması gerekir, bu işlev artık "Durumu Denetle ve Sonuçları Al" içinde sarmalanır.

Bilinen sorunlar ve sınırlamalar

  1. Join komutu yürütürken şu anda yinelenen sütunları desteklemiyoruz. Yinelenen sütunlara diğer adlar eklemek geçici bir çözüm olabilir.

  2. Sanal Tablolarla ilgili diğer sınırlamalar burada listelenmiştir.

  3. Sanal tablolar yalnızca 'Hizmet Sorumlusu' kimlik doğrulamasıyla oluşturulan bağlantılarla desteklenir.

  4. Hizmet İlkesi kimlik doğrulamasını kullanırken kullanıcının information_schema.columns tablosuna Okuma erişimine sahip olması gerekir.

  5. Snowflake bağlantıları doğrudan Tuval uygulamalarında oluşturulamaz, sorunu çözmek için gereken hata bilgileri ve adımlar şunlardır:

    1. Aşağıdaki ekran görüntüsünde gösterildiği gibi Snowflake bağlantısının doğrudan bir Tuval uygulamasında oluşturulup oluşturulmayacağını gösteren bir hata görüntüleniyor Bağlantı bağlantısıoluşturma hatası
    2. Bağlayıcıyı doğrudan Tuval uygulamasına eklemek yerine, Canvas uygulamasının dışından bir hizmet sorumlusu bağlantısı (temsilci olarak atanmaması) oluşturun
    3. Yukarıda oluşturulan Snowflake bağlantısını kullanın ve sanal tablo Oluşturma Bağlantı hatası
    4. Daha sonra, sanal tablo Tuval uygulamasına yüklenebilir ve Tuval uygulamasından derlenebilir bağlantı hatası devam edebilir
    5. Yukarıdaki ANIMALS tablosu, yukarıda belirtildiği gibi Snowflake Bağlantısı kullanılarak oluşturulmuş bir sanal tablodur

Uyarı

  1. Kullanıcıların snowflake hesabı ayrıntılarının (ambar, rol, şema, veritabanı) her zaman Snowflake hesabıyla aynı harf durumunda olduğundan emin olması gerekir ve bağlantı/akış eylemleri yapılandırılır.
  2. Hem Temsilci hem de Hizmet Sorumlusu tabanlı bağlantılar için doğrulama adımı olarak lütfen bağlantıyı doğrulamak için bir Power Automate akışı oluşturun.

Genel Sınırlar

İsim Değer
Bağlayıcı tarafından eşzamanlı olarak işlenen en fazla istek sayısı 50

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:

Hizmet sorumlusu (Microsoft Entra ID uygulaması) Snowflake veritabanınıza erişmek için Microsoft Entra ID uygulamasını kullanın. Tüm bölgeler Paylaşılabilir
Hizmet sorumlusu Temsilci Kimlik Doğrulaması (Microsoft Entra Id uygulaması) Snowflake veritabanınıza erişmek için Microsoft Entra ID uygulamasını kullanın. Tüm bölgeler Paylaşılabilir
Varsayılan [KULLANIM DIŞI] Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır. Tüm bölgeler Paylaşılamaz

Hizmet sorumlusu (Microsoft Entra ID uygulaması)

Kimlik Doğrulama Kimliği: oauthSP

Geçerli: Tüm bölgeler

Snowflake veritabanınıza erişmek için Microsoft Entra ID uygulamasını kullanın.

Bu, paylaşılabilir bir bağlantıdır. Power app başka bir kullanıcıyla paylaşılıyorsa, bağlantı da paylaşılır. Daha fazla bilgi için bkz . Tuval uygulamaları için bağlayıcılara genel bakış - Power Apps | Microsoft Docs

İsim Türü Description Gerekli
Tenant String Doğru
Müşteri Kimliği String Doğru
İstemci Sırrı securestring Doğru
Kaynak URL String Snowflake OAuth Hedef Kitle URL'si (Kaynak URL'si) Doğru
Snowflake SaaS URL'si String HTTPS ön eki dahil olmayan snowflake URL'si (örneğin, fnpuupu-in12345.snowflakecomputing.com) Doğru
Snowflake veritabanı String Bağlanılacak veritabanını belirtin Doğru
Ambar adı String Bağlanacak snowflake ambarı Doğru
Rol String Bağlanmak için snowflake rolü Doğru
Schema String Bağlanacak snowflake şeması Doğru

Hizmet sorumlusu Temsilci Kimlik Doğrulaması (Microsoft Entra Id uygulaması)

Kimlik Doğrulama Kimliği: oauthSPUserDelegated

Geçerli: Tüm bölgeler

Snowflake veritabanınıza erişmek için Microsoft Entra ID uygulamasını kullanın.

Bu, paylaşılabilir bir bağlantıdır. Power app başka bir kullanıcıyla paylaşılıyorsa, bağlantı da paylaşılır. Daha fazla bilgi için bkz . Tuval uygulamaları için bağlayıcılara genel bakış - Power Apps | Microsoft Docs

İsim Türü Description Gerekli
Müşteri Kimliği String Snowflake OAuth İstemci Kimliği Doğru
İstemci Sırrı securestring Snowflake OAuth İstemci Gizli Anahtarı Doğru
Kaynak URL String Snowflake OAuth İzleyici URL'si (Kaynak URL'si) Doğru

Varsayılan [KULLANIM DIŞI]

Geçerli: Tüm bölgeler

Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim Türü Description Gerekli
Bu, MCS UI bağlantı pencere öğesi hatası nedeniyle zaman için gerekli olan sahte bir yer tutucudur. Tüm kimlik doğrulama değişiklikleri connectionParameterSets içinde yapılmalıdır String Bu, MCS UI bağlantı pencere öğesi hatası nedeniyle zaman için gerekli olan sahte bir yer tutucudur. Tüm kimlik doğrulama değişiklikleri connectionParameterSets içinde yapılmalıdır

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 900 60 saniye

Eylemler

Deyimin Yürütülmesini İptal Etme

Deyimin Yürütülmesini İptal Etme

Durumu Denetleme ve Sonuçları Alma

Bir Deyimi Yürütme Durumunu Denetleme ve Sonuçları Alma

Sql Deyimini Yürütme için Gönderme

Yürütme için SQL Deyimi Gönderme

Deyimin Yürütülmesini İptal Etme

Deyimin Yürütülmesini İptal Etme

Parametreler

Name Anahtar Gerekli Tür Description
Örnek
Instance True string

Snowflake örneğinizin uri'sini (https:// olmadan)

deyim tutamacı
statementHandle True string

deyim tutamacı

Talep Kimliği
requestId string

Talep Kimliği

Döndürülenler

Name Yol Tür Description
kod
code string

kod

sqlState
sqlState string

sqlState

message
message string

message

statementHandle
statementHandle string

statementHandle

statementStatusUrl
statementStatusUrl string

statementStatusUrl

Durumu Denetleme ve Sonuçları Alma

Bir Deyimi Yürütme Durumunu Denetleme ve Sonuçları Alma

Parametreler

Name Anahtar Gerekli Tür Description
Örnek
Instance True string

Snowflake örneğinizin uri'sini (https:// olmadan)

deyim tutamacı
statementHandle True string

deyim tutamacı

Talep Kimliği
requestId string

Talep Kimliği

bölüm
partition integer

bölüm

name
name string

name

veritabanı
database string

veritabanı

şema
schema string

şema

table
table string

table

nullable
nullable boolean

nullable

kesinlik
precision integer

kesinlik

scale
scale integer

scale

byteLength
byteLength integer

byteLength

Harmanlama
collation string

Harmanlama

length
length integer

length

type
type string

type

Döndürülenler

Name Yol Tür Description
Partitions
Partitions array of object

Partitions

RowCount
Partitions.RowCount integer

RowCount

UncompressedSize
Partitions.UncompressedSize integer

UncompressedSize

CompressedSize
Partitions.CompressedSize integer

CompressedSize

Schema
Schema array of object

Schema

name
Schema.name string

name

veritabanı
Schema.database string

veritabanı

şema
Schema.schema string

şema

table
Schema.table string

table

kesinlik
Schema.precision integer

kesinlik

scale
Schema.scale integer

scale

type
Schema.type string

type

nullable
Schema.nullable boolean

nullable

byteLength
Schema.byteLength integer

byteLength

Harmanlama
Schema.collation string

Harmanlama

length
Schema.length integer

length

Data
Data array of

Data

StatementHandle
StatementHandle string

StatementHandle

Rows
Metadata.Rows integer

Rows

Biçim
Metadata.Format string

Biçim

Kod
Metadata.Code string

Kod

StatementStatusUrl
Metadata.StatementStatusUrl string

StatementStatusUrl

RequestId
Metadata.RequestId string

RequestId

SqlState
Metadata.SqlState string

SqlState

CreatedOn
Metadata.CreatedOn string

CreatedOn

StatementHandles
Metadata.StatementHandles array of string

Birden çok deyimi yürütmeye yönelik StatementHandles

Sql Deyimini Yürütme için Gönderme

Yürütme için SQL Deyimi Gönderme

Parametreler

Name Anahtar Gerekli Tür Description
Örnek
Instance True string

Snowflake örneğinizin uri'sini (https:// olmadan)

Talep Kimliği
requestId string

İsteğin Kimliği

Asynchronous
asyncexecution boolean

Sorgunun zaman uyumsuz olarak yürütülmesi gerekip gerekmediğini gösterir

Null olabilir
nullable boolean

Null atanabilir false ise, null değerler dizeyle değiştirilir

açıklama
statement string

Yürütülecek SQL deyimi - henüz desteklenmeyen deyim toplu işlemleri

timeout
timeout integer

Zaman aşımı gerçekleşmeden önceki saniye sayısı

veritabanı
database string

veritabanı

şema
schema string

şema

warehouse
warehouse string

warehouse

role
role string

role

timezone
timezone string

deyimi yürütülürken kullanılacak saat dilimi.

sorgu etiketi
query_tag string

SQL deyimiyle ilişkilendirmek istediğiniz sorgu etiketi.

ikili çıkış biçimi
binary_output_format string

İkili değerler için çıkış biçimi.

tarih çıkış biçimi
date_output_format string

TARİh değerleri için çıkış biçimi.

zaman çıkış biçimi
time_output_format string

TIME değerleri için çıkış biçimi.

zaman damgası çıkış biçimi
timestamp_output_format string

TIMESTAMP değerleri için çıkış biçimi.

zaman damgası ltz çıkış biçimi
timestamp_ltz_output_format string

TIMESTAMP_LTZ değerleri için çıkış biçimi.

timestamp_ntz_output_format
timestamp_ntz_output_format string

TIMESTAMP_NTZ değerleri için çıkış biçimi.

zaman damgası tz çıkış biçimi
timestamp_tz_output_format string

TIMESTAMP_TZ değerleri için çıkış biçimi.

multi deyimi sayısı
MULTI_STATEMENT_COUNT integer

Çoklu deyim özelliği kullanılırken yürütülecek deyim sayısı. 0, değişken deyim sayısını ifade eder. Negatif sayılara izin verilmez.

Döndürülenler

Name Yol Tür Description
Partitions
Partitions array of object

Partitions

RowCount
Partitions.RowCount integer

RowCount

UncompressedSize
Partitions.UncompressedSize integer

UncompressedSize

CompressedSize
Partitions.CompressedSize integer

CompressedSize

Schema
Schema array of object

Schema

name
Schema.name string

name

veritabanı
Schema.database string

veritabanı

şema
Schema.schema string

şema

table
Schema.table string

table

nullable
Schema.nullable boolean

nullable

kesinlik
Schema.precision integer

kesinlik

scale
Schema.scale integer

scale

byteLength
Schema.byteLength integer

byteLength

Harmanlama
Schema.collation string

Harmanlama

length
Schema.length integer

length

type
Schema.type string

type

Data
Data array of

Data

Rows
Metadata.Rows integer

Rows

Biçim
Metadata.Format string

Biçim

Kod
Metadata.Code string

Kod

StatementStatusUrl
Metadata.StatementStatusUrl string

StatementStatusUrl

RequestId
Metadata.RequestId string

RequestId

SqlState
Metadata.SqlState string

SqlState

StatementHandle
Metadata.StatementHandle string

StatementHandle

StatementHandles
Metadata.StatementHandles array of string

Birden çok deyimi yürütmeye yönelik StatementHandles

CreatedOn
Metadata.CreatedOn string

CreatedOn