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. 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-ANYtanımlayın. - 2. Adım: Microsoft Entra Id'de OAuth İstemcisi oluşturma bölümünde 1-13 arası adımları izleyin.
- 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.
- 1. Adımda oluşturulan kaynağa gidin ve API'yi kullanıma sunma -İstemci uygulaması ekleme ->>Yukarıdaki 3. adımda öğesini ekleyin
APPLICATION_CLIENT_ID->Kaydet'e tıklayın - 3. Adımı izleyin: Snowflake için Microsoft Entra ID Bilgilerini tamamen toplayın.
- 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 ileApplication ID URIdeğ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 ileemail_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ü olarakACCOUNTADMINayarladığı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
- 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.
- 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.
- Bağlayıcı büyük sorgu sonuçlarıyla zaman aşımına uğradı.
FAQ
- 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ı. |