Aracılığıyla paylaş


Kar Tanesi (Kullanım Dışı)

Snowflake, geleneksel tekliflere göre daha hızlı, kullanımı daha kolay ve daha esnek veri depolama, işleme ve analiz çözümleri sağlar.

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

Hizmet Class Bölgeler
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 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)
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)
İletişim
İsim Snowflake
URL https://www.snowflake.com/support
E-posta support@snowflake.com
Bağlayıcı Meta Verileri
Publisher Snowflake Inc.
Web sitesi https://www.snowflake.com
Gizlilik ilkesi https://www.snowflake.com/privacy-policy
Kategoriler Data

Uyarı

Bu bağlayıcı kullanım dışı bırakıldı, lütfen bu bağlayıcıya gelişmiş bir alternatif kullanın: Snowflake (önizleme) bağlayıcısı

Bu bağlayıcı Snowflake SQL REST API'sini temel alır. Snowflake'in Veri Bulutu, kendi kendine yönetilen bir hizmet olarak sağlanan gelişmiş bir veri platformu tarafından desteklenir. Snowflake, geleneksel tekliflere göre daha hızlı, kullanımı daha kolay ve çok daha esnek veri depolama, işleme ve analiz çözümleri sağlar. Bağlayıcı, zaman uyumlu ve zaman uyumsuz sorgular göndermek ve ilgili sonuçları almak için Snowflake REST API V2'yi kullanır.

Önkoşullar

Bu bağlayıcıyı kullanmak için gereken tüm önkoşullar hakkında bilgi sağlayın. Örneğin, web sitenizdeki bir hesap veya ücretli bir hizmet planı.

Kimlik bilgilerini alma

Aşağıdaki adımları izleyerek Snowflake için Microsoft Entra Id kimlik doğrulamasını ayarlayın:

  1. 1. Adım: Microsoft Entra Id'de OAuth Kaynağını Yapılandırma bölümünde, 1-10 arası adımları izleyin ve bu yönergeleri izleyerek kapsamı olarak SESSION:ROLE-ANY tanımlayın.
  2. 2. Adım: Microsoft Entra Id'de OAuth İstemcisi oluşturma bölümünde 1-13 arası adımları izleyin.
  3. Kimlik Doğrulaması ->Platform yapılandırmaları ->Platform ekle ->Ekle "https://global.consent.azure-apim.net/redirect" ->Kaydet'e tıklayın. Yeniden yönlendirme URL'sinin Snowflake OAuth Kaynağında değil Snowflake OAuth İstemcisi'nde ayarlandığından emin olun.
  4. 1. Adımda oluşturulan kaynağa gidin ve API'yi kullanıma sunma -İstemci uygulaması ekleme ->>Yukarıdaki 3. adımda öğesini ekleyinAPPLICATION_CLIENT_ID ->Kaydet'e tıklayın
  5. 3. Adımı izleyin: Snowflake için Microsoft Entra ID Bilgilerini tamamen toplayın.
  6. Aşağıdaki metni kopyalayıp Snowflake çalışma sayfanıza yapıştırın. Burada sorgularınızı Snowflake'te yürütebilirsiniz. Sorguyu yürütmeden önce, sorgunuzun başarılı olması için aşağıdaki değişiklikleri yaptığınızdan emin olun. A. Microsoft Azure'da Snowflake OAuth Kaynak uygulamanıza gidin ve Uç Noktalar'a tıklayın. B. 5. satırdaki AZURE_AD_ISSUER almak için , Federasyon meta verileri belge alanındaki bağlantıyı kopyalayın ve bağlantıyı yeni bir sekmede açın. Şuna benzer olması gereken entityID bağlantısını kopyalayın: https://sts.windows.net/90288a9b-97df-4c6d-b025-95713f21cef9/. Sorguya yapıştırın ve son tırnak işaretinden önce bir / işaretiniz olduğundan ve tırnak işaretlerini tuttuğunuzdan emin olun. C. 6. satırdaki Anahtarlar URL'sini almak için OpenID Connect meta veri belge alanındaki bağlantıyı kopyalayın ve bağlantıyı yeni bir sekmede açın. Şuna benzer olması gereken jwks_uri kopyalayın: https://login.microsoftonline.com/90288a9b-97df-4c6d-b025-95713f21cef9/discovery/v2.0/keys. Sorguya yapıştırın ve tırnak işaretlerini tuttuğunuzdan emin olun.
    D. 7. satırdaki hedef kitle listesi URL'sini 1. Adım ile Application ID URI değiştirin. Tırnak işaretlerini koruyun.
    E. Snowflake hesabınız Microsoft Azure hesabınızla aynı e-posta adresini kullanıyorsa, 9. satırdaki değerini ile email_addressdeğiştirinlogin_name. Aksi takdirde olduğu gibi saklayın ve oturum açma adınızı yazmayın. Tırnak işaretlerini koruyun.
    F. Rolünüzü olarak ACCOUNTADMINayarladığınızdan emin olun. Artık sorgunuzu yürütebilirsiniz.
create security integration connector
       type = external_oauth
       enabled = true
       external_oauth_type = azure
       external_oauth_issuer = '<AZURE_AD_ISSUER>'     
       external_oauth_jws_keys_url = 'https://login.windows.net/common/discovery/keys'
       external_oauth_audience_list = ('https://analysis.usgovcloudapi.net/powerbi/connector/snowflake')
       external_oauth_token_user_mapping_claim = 'upn'
       external_oauth_snowflake_user_mapping_attribute = 'login_name'
       external_oauth_any_role_mode = 'ENABLE';

Bağlayıcınızı kullanmaya başlama

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

Durumu Denetleme ve Sonuçları Alma

Deyimin Yürütülmesini İptal Etme

Bilinen sorunlar ve sınırlamalar

  1. Yeni bağlantı oluştururken 500 yanıtı alırsanız, bu geçici bir hatadır. Lütfen birkaç dakika bekleyin ve tekrar deneyin.
  2. 401 yanıtı alırsanız ve 1. Adım'daki Konak alanınız bu "orgname-accountname" biçimini izlerse, Konak alanını "bulucu" URL'nizle değiştirin.
  3. Bağlayıcı büyük sorgu sonuçlarıyla zaman aşımına uğradı.

FAQ

  1. Bağlayıcı Power Apps içinde nasıl kullanılabilir? Power Apps şu anda dinamik şemayı desteklememektedir. Bağlayıcıyı doğrudan uygulamadan değil, uygulamadan bir akış çağırarak Power Apps'ten kullanmaya devam edebilirsiniz.

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 100 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

Sonuç kümesi satırlarını diziden nesnelere dönüştürme

Sonuç kümesi satırlarını diziden nesnelere dönüştürme

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

Döndürülenler

Name Yol Tür Description
kod
code string
sqlState
sqlState string
message
message string
statementHandle
statementHandle string
createdOn
createdOn integer

Deyimi yürütmenin ne zaman başlatıldığını belirten zaman damgası. Zaman damgası, dönemden bu yana milisaniye cinsinden ifade edilir

statementStatusUrl
statementStatusUrl string
format
resultSetMetaData.format string

v2 uç noktaları için bu alan için tek olası değer jsonv2'dir.

rowType
resultSetMetaData.rowType array of object
name
resultSetMetaData.rowType.name string
type
resultSetMetaData.rowType.type string
nullable
resultSetMetaData.rowType.nullable boolean
partitionInfo
partitionInfo array of object

Bölüm bilgileri

rowCount
partitionInfo.rowCount integer

Bölümdeki satır sayısı.

compressedSize
partitionInfo.compressedSize integer

sıkıştırmadan önceki bölüm boyutu. Bu, partitionInfo'da mevcut olabilir veya olmayabilir. Sıkıştırılmamış boyut her zaman orada olur.

uncompressedSize
partitionInfo.uncompressedSize integer

sıkıştırmadan sonraki bölüm boyutu

nullable
nullable boolean

null değeri 'null' dizesiyle değiştirilirse false, aksi takdirde false

veriler
data array of array

Sonuç kümesi verileri.

items
data array of string
numRowsInserted
stats.numRowsInserted integer

Eklenen satır sayısı.

numRowsUpdated
stats.numRowsUpdated integer

Güncelleştirilen satır sayısı.

numRowsDeleted
stats.numRowsDeleted integer

Silinen satır sayısı.

numDuplicateRowsUpdated
stats.numDuplicateRowsUpdated integer

Güncelleştirilen yinelenen satır sayısı.

Sonuç kümesi satırlarını diziden nesnelere dönüştürme

Sonuç kümesi satırlarını diziden nesnelere dönüştürme

Parametreler

Name Anahtar Gerekli Tür Description
rowType
resultSetMetaData string
veriler
data string

Döndürülenler

Name Yol Tür Description
veriler
data array of object

Sonuç kümesi verileri.

items
data object

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
async boolean

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

nullable
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
kod
code string
sqlState
sqlState string
message
message string
statementHandle
statementHandle string
createdOn
createdOn integer

Deyimi yürütmenin ne zaman başlatıldığını belirten zaman damgası. Zaman damgası, dönemden bu yana milisaniye cinsinden ifade edilir

statementStatusUrl
statementStatusUrl string
format
resultSetMetaData.format string

v2 uç noktaları için bu alan için tek olası değer jsonv2'dir.

rowType
resultSetMetaData.rowType array of object
name
resultSetMetaData.rowType.name string
type
resultSetMetaData.rowType.type string
nullable
resultSetMetaData.rowType.nullable boolean
partitionInfo
partitionInfo array of object

Bölüm bilgileri

rowCount
partitionInfo.rowCount integer

Bölümdeki satır sayısı.

compressedSize
partitionInfo.compressedSize integer

sıkıştırmadan önceki bölüm boyutu. Bu, partitionInfo'da mevcut olabilir veya olmayabilir. Sıkıştırılmamış boyut her zaman orada olur.

uncompressedSize
partitionInfo.uncompressedSize integer

sıkıştırmadan sonraki bölüm boyutu

nullable
nullable boolean

null değeri 'null' dizesiyle değiştirilirse false, aksi takdirde false

veriler
data array of array

Sonuç kümesi verileri.

items
data array of string
numRowsInserted
stats.numRowsInserted integer

Eklenen satır sayısı.

numRowsUpdated
stats.numRowsUpdated integer

Güncelleştirilen satır sayısı.

numRowsDeleted
stats.numRowsDeleted integer

Silinen satır sayısı.

numDuplicateRowsUpdated
stats.numDuplicateRowsUpdated integer

Güncelleştirilen yinelenen satır sayısı.