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

ŞUNLARA UYGULANIR: Azure Data Factory Azure Synapse Analytics

İpucu

Microsoft Fabric'daki Data Factory, daha basit bir mimariye, yerleşik yapay zekaya ve yeni özelliklere sahip yeni nesil Azure Data Factory. Veri tümleştirmeyi yeni kullanmaya başladıysanız Fabric Data Factory ile başlayın. Mevcut ADF iş yükleri veri bilimi, gerçek zamanlı analiz ve raporlama genelinde yeni özelliklere erişmek için Fabric yükseltebilir.

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'ye yeniyseniz, bu makaleyi okumadan önce Azure Data Factory'ye Giriş makalesini okuyun ve şu öğreticiyi yapın: Öğretici: Verileri Dönüştürme. Synapse Analytics hakkında daha fazla bilgi edinmek için Azure Synapse Analytics okuyun.

Saklı Yordam Etkinliği'ni kullanarak kuruluşunuzdaki veya Azure bir sanal makinedeki (VM) aşağıdaki veri depolarından birinde saklı yordamı çağırabilirsiniz:

  • Azure SQL Database
  • Azure Synapse Analytics
  • veritabanı SQL Server. SQL Server kullanıyorsanız, veritabanı sunucusunu barındıran makineye veya veritabanına erişimi olan farklı bir makineye yerel barındırılan tümleştirme çalışma zamanını yükleyin. Self-Hosted tümleştirme çalışma zamanı, şirket içi/Azure VM'deki veri kaynaklarını bulut hizmetlerine güvenli ve yönetilen bir şekilde bağlayan bir bileşendir. Ayrıntılar için Öz-yerleşimli tümleştirme çalışma zamanı makalesine bakın.

Önemli

Verileri Azure SQL Database veya SQL Server kopyalarken, sqlWriterStoredProcedureName özelliğini kullanarak saklı yordamı çağırmak için kopyalama etkinliğinde SqlSink yapılandırabilirsiniz. Özelliği hakkında ayrıntılı bilgi için şu bağlayıcı makalelerine bakın: Azure SQL Database, SQL Server. Kopyalama etkinliği kullanarak verileri bir Azure Synapse Analytics'e kopyalarken saklı yordamı çağırmak desteklenmez. Azure Synapse Analytics içinde bir saklı yordamı çağırmak için saklı yordam etkinliğini kullanabilirsiniz.

verileri Azure SQL Database, SQL Server veya Azure Synapse Analytics kopyalarken, sqlReaderStoredProcedureName özelliğini kullanarak kaynak veritabanından veri okumak üzere 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 Database, SQL Server, Azure Synapse Analytics

Saklı yordamda Çıkış parametreleri olduğunda, saklı yordam etkinliğini kullanmak yerine arama etkinliğini 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 ekibiyle iletişime geçin. Sql hata numarası: 201. Hata İletisi: 'sp_name' yordamı veya işlevi, sağlanmayan '@output_param_name' parametresini bekliyor.

Kullanıcı arabirimiyle Saklı Prosedür aktivitesi oluşturma

İşlem hattında Saklı Yordam aktivitesini kullanmak için şu adımları izleyin:

  1. İşlem hattı Etkinlikleri bölmesinde Saklı Yordam Etkinliğini 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 Database, Azure Synapse Analytics veya SQL Server 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
Tip Saklı Yordam Etkinliği için aktivite türü SqlServerStoredProcedure'dur Yes
bağlantılıHizmetAdı Data Factory'de bağlı hizmet olarak kaydedilen Azure SQL Database veya Azure Synapse Analytics veya SQL Server başvurusu. Bu bağlı hizmet hakkında bilgi edinmek için Bağlı hizmetleri hesaplama makalesine bakın. Yes
storedProcedureName Çağrılacak saklı yordamın adını belirtin. Yes
saklıProsedürParametreleri 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:

  • Last updated on