Azure Data Factory veya Synapse Analytics'te SQL Server Saklı Yordam etkinliğini kullanarak verileri dönüştürme
UYGULANANLAR:
Azure Data Factory Azure Synapse Analytics
İpucu
Kuruluşlar için hepsi bir arada analiz çözümü olan Microsoft Fabric'te Data Factory'yi deneyin. Microsoft Fabric , veri taşımadan veri bilimine, gerçek zamanlı analize, iş zekasına ve raporlamaya kadar her şeyi kapsar. Yeni bir deneme sürümünü ücretsiz olarak başlatmayı öğrenin!
Ham verileri tahminlere ve içgörülere dönüştürmek ve işlemek için Data Factory veya Synapse işlem hattında veri dönüştürme etkinliklerini kullanırsınız. Saklı Yordam Etkinliği, işlem hatlarının desteklediği dönüştürme etkinliklerinden biridir. Bu makale, veri dönüştürme ve desteklenen dönüştürme etkinliklerine genel bir genel bakış sunan dönüştürme verileri makalesini temel alır.
Not
Azure Data Factory'yi yeni kullanıyorsanız Azure Data Factory'ye giriş makalesini okuyun ve öğretici: Öğretici: Bu makaleyi okumadan önce verileri dönüştürme. Synapse Analytics hakkında daha fazla bilgi edinmek için Bkz . Azure Synapse Analytics nedir?
Saklı Yordam Etkinliği'ni kullanarak kuruluşunuzdaki veya Azure sanal makinesindeki (VM) aşağıdaki veri depolarından birinde saklı yordamı çağırabilirsiniz:
- Azure SQL Veritabanı
- Azure Synapse Analytics
- SQL Server Veritabanı. SQL Server kullanıyorsanız, veritabanını barındıran makineye veya veritabanına erişimi olan ayrı bir makineye Şirket içinde barındırılan tümleştirme çalışma zamanı yükleyin. Şirket İçinde Barındırılan tümleştirme çalışma zamanı, şirket içindeki/Azure VM'deki veri kaynaklarını bulut hizmetleriyle güvenli ve yönetilen bir şekilde bağlayan bir bileşendir. Ayrıntılar için Şirket içinde barındırılan tümleştirme çalışma zamanı makalesine bakın.
Önemli
verileri Azure SQL Veritabanı veya SQL Server'a kopyalarken, sqlWriterStoredProcedureName özelliğini kullanarak saklı yordamı çağırmak için kopyalama etkinliğinde SqlSink'i yapılandırabilirsiniz. Özelliği hakkında ayrıntılı bilgi için şu bağlayıcı makalelerine bakın: Azure SQL Veritabanı, SQL Server. Kopyalama etkinliği kullanarak verileri Azure Synapse Analytics'e kopyalarken saklı yordamı çağırmak desteklenmez. Ancak saklı yordam etkinliğini kullanarak Azure Synapse Analytics'te saklı yordamı çağırabilirsiniz.
Azure SQL Veritabanı, SQL Server veya Azure Synapse Analytics'ten veri kopyalarken sqlReaderStoredProcedureName özelliğini kullanarak kaynak veritabanından veri okumak için saklı yordamı çağırmak üzere kopyalama etkinliğinde SqlSource'ı yapılandırabilirsiniz. Daha fazla bilgi için şu bağlayıcı makalelerine bakın: Azure SQL Veritabanı, SQL Server, Azure Synapse Analytics
Saklı yordamın Output parametreleri olduğunda saklı yordam etkinliğini kullanmak yerine arama işlevini ve Betik etkinliğini kullanın. Saklı yordam etkinliği henüz Output parametresine sahip SP'leri çağırmayı desteklemiyor.
Saklı yordam etkinliğini kullanarak çıkış parametreleriyle saklı yordamı çağırırsanız aşağıdaki hata oluşur.
Sql Server'da yürütme başarısız oldu. Daha fazla desteğe ihtiyacınız varsa lütfen SQL Server ekibine başvurun. Sql hata numarası: 201. Hata İletisi: 'sp_name' yordamı veya işlevi, sağlanmayan '@output_param_name' parametresini bekliyor.
Kullanıcı arabirimiyle Saklı Yordam etkinliği oluşturma
İşlem hattında Saklı Yordam etkinliğini kullanmak için aşağıdaki adımları tamamlayın:
İşlem hattı Etkinlikleri bölmesinde Saklı Yordam'ı arayın ve saklı yordam etkinliğini işlem hattı tuvaline sürükleyin.
Tuvalde henüz seçili değilse yeni Saklı Yordam etkinliğini ve ayrıntılarını düzenlemek için Ayarlar sekmesini seçin.
Var olan bir hizmeti seçin veya bir Azure SQL Veritabanı, Azure Synapse Analytics veya SQL Server'a yeni bir bağlı hizmet oluşturun.
Bir saklı yordam seçin ve yürütülmesi için tüm parametreleri sağlayın.
Söz dizimi ayrıntıları
Saklı Yordam Etkinliği tanımlamak için JSON biçimi aşağıdadır:
{
"name": "Stored Procedure Activity",
"description":"Description",
"type": "SqlServerStoredProcedure",
"linkedServiceName": {
"referenceName": "AzureSqlLinkedService",
"type": "LinkedServiceReference"
},
"typeProperties": {
"storedProcedureName": "usp_sample",
"storedProcedureParameters": {
"identifier": { "value": "1", "type": "Int" },
"stringData": { "value": "str1" }
}
}
}
Aşağıdaki tabloda bu JSON özellikleri açıklanmaktadır:
| Özellik | Açıklama | Gerekli |
|---|---|---|
| Adı | Etkinliğin adı | Yes |
| açıklama | Etkinliğin ne için kullanıldığını açıklayan metin | Hayır |
| Tür | Saklı Yordam Etkinliği için etkinlik türü SqlServerStoredProcedure'dur | Yes |
| linkedServiceName | Data Factory'de bağlı hizmet olarak kaydedilen Azure SQL Veritabanı veya Azure Synapse Analytics veya SQL Server'a başvuru. Bu bağlı hizmet hakkında bilgi edinmek için bkz . Bağlı hizmetleri hesaplama makalesi. | Yes |
| storedProcedureName | Çağrılacak saklı yordamın adını belirtin. | Yes |
| storedProcedureParameters | Saklı yordam parametrelerinin değerlerini belirtin. Veri kaynağı tarafından desteklenen parametre değerlerini ve türlerini geçirmek için kullanın "param1": { "value": "param1Value","type":"param1Type" } . Bir parametre için null geçirmeniz gerekiyorsa kullanın "param1": { "value": null } (tümü küçük harf). |
Hayır |
Parametre veri türü eşlemesi
parametresi için belirttiğiniz veri türü, kullanmakta olduğunuz veri kaynağındaki veri türüyle eşleşen iç hizmet türüdür. Veri kaynağınızın veri türü eşlemelerini bağlayıcılar belgelerinde bulabilirsiniz. Örneğin:
- Azure Synapse Analytics
- veri türü eşlemesini Azure SQL Veritabanı
- Oracle veri türü eşlemesi
- SQL Server veri türü eşlemesi
İlgili içerik
Verileri başka şekillerde dönüştürmeyi açıklayan aşağıdaki makalelere bakın: