Aracılığıyla paylaş

Azure Data Factory veya Synapse Analytics'te SQL Server Saklı Yordam etkinliğini kullanarak verileri dönüştürme

  • Makale

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:

  1. İşlem hattı Etkinlikleri bölmesinde Saklı Yordam'ı arayın ve saklı yordam etkinliğini işlem hattı tuvaline sürükleyin.

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

    Saklı Yordam etkinliğinin kullanıcı arabirimini gösterir.

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

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

İlgili içerik

Verileri başka şekillerde dönüştürmeyi açıklayan aşağıdaki makalelere bakın: