Azure Data Factory veya Azure Synapse Analytics kullanarak SharePoint Online Listesi'nden veri kopyalama

Makale
01/05/2024

UYGULANANLAR: Azure Data Factory Azure Synapse Analytics

Bahşiş

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!

Bu makalede, SharePoint Online List'ten veri kopyalamak için Azure Data Factory ve Azure Synapse işlem hatlarında Kopyalama Etkinliği'nin nasıl kullanılacağı özetlenmiştir. Makale, Kopyalama Etkinliği'ne genel bir genel bakış sunan Kopyalama Etkinliği üzerine derlenmektedir.

Desteklenen özellikler

Bu SharePoint Online Listesi bağlayıcısı aşağıdaki özellikler için desteklenir:

Desteklenen özellikler	IR
Kopyalama etkinliği (kaynak/-)	① ②
Arama etkinliği	① ②

(1) Azure tümleştirme çalışma zamanı (2) Şirket içinde barındırılan tümleştirme çalışma zamanı

Kaynak veya havuz olarak desteklenen veri depolarının listesi için Desteklenen veri depoları tablosuna bakın.

Özellikle, bu SharePoint List Online bağlayıcısı hizmet sorumlusu kimlik doğrulamayı kullanır ve OData protokolü aracılığıyla veri alır.

Bahşiş

Bu bağlayıcı, SharePoint Online Listesi'nden veri kopyalamayı destekler, ancak dosya kopyalamayı desteklemez. SharePoint Online'dan dosya kopyalama bölümünden dosya kopyalamayı öğrenin.

Önkoşullar

SharePoint List Online bağlayıcısı, SharePoint'e bağlanmak için hizmet sorumlusu kimlik doğrulamasını kullanır. Ayarlamak için şu adımları izleyin:

Bir uygulamayı Microsoft kimlik platformu kaydedin. Nasıl yapılacağını öğrenmek için bkz. Hızlı Başlangıç: uygulamayı Microsoft kimlik platformu kaydetme. Bağlı hizmeti tanımlamak için kullandığınız şu değerleri not edin:
- Uygulama Kimliği
- Uygulama anahtarı
- Kiracı kimliği
Aşağıdaki adımları izleyerek kayıtlı uygulamanıza SharePoint Online sitesi izni verin. Bunu yapmak için bir site yöneticisi rolüne sahip olmanız gerekir.
1. SharePoint Online site bağlantısını (örneğin, https://[your_site_url]/_layouts/15/appinv.aspx site URL'sini değiştirin) açın.
2. Kaydettiğiniz uygulama kimliğini arayın, boş alanları doldurun ve "Oluştur"a tıklayın.
  - Uygulama Etki Alanı: contoso.com
  - Yeniden yönlendirme URL'si: https://www.contoso.com
  - İzin İsteği XML'i:
```
<AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read"/>
</AppPermissionRequests>
```
  Dekont
  
  SharePoint bağlayıcısını yapılandırma bağlamında, "Uygulama Etki Alanı" ve "Yeniden Yönlendirme URL'si", SharePoint verilerinize erişime izin vermek için Microsoft Entra Id'ye kaydettiğiniz SharePoint uygulamasına başvurur. "Uygulama Etki Alanı", SharePoint sitenizin barındırıldığı etki alanıdır. Örneğin, SharePoint siteniz "https://contoso.sharepoint.com"" konumundaysa, "Uygulama Etki Alanı" "contoso.sharepoint.com" olur. "Yeniden Yönlendirme URL'si", kullanıcı kimlik doğrulaması yaptıktan ve uygulamaya izin verdikten sonra SharePoint uygulamasının yeniden yönlendireceği URL'dir. Bu URL, SharePoint sitenizde uygulamanın erişim iznine sahip olduğu bir sayfa olmalıdır. Örneğin, kitaplıktaki dosyaların listesini görüntüleyen bir sayfanın URL'sini veya belgenin içeriğini görüntüleyen bir sayfayı kullanabilirsiniz.
3. Bu uygulama için "Güven" seçeneğine tıklayın.

Başlarken

İşlem hattıyla Kopyalama etkinliği gerçekleştirmek için aşağıdaki araçlardan veya SDK'lardan birini kullanabilirsiniz:

Kullanıcı arabirimini kullanarak SharePoint Online Listesine bağlı hizmet oluşturma

Azure portalı kullanıcı arabiriminde sharepoint online listesine bağlı hizmet oluşturmak için aşağıdaki adımları kullanın.

Azure Data Factory veya Synapse çalışma alanınızda Yönet sekmesine göz atın ve Bağlı Hizmetler'i seçin, ardından Yeni'ye tıklayın:
- Azure Data Factory
- Azure Synapse
SharePoint'i arayın ve SharePoint Online Listesi bağlayıcısını seçin.
Hizmet ayrıntılarını yapılandırın, bağlantıyı test edin ve yeni bağlı hizmeti oluşturun.

Bağlan veya yapılandırma ayrıntıları

Aşağıdaki bölümlerde, SharePoint Online Listesi bağlayıcısına özgü varlıkları tanımlamak için kullanabileceğiniz özelliklerle ilgili ayrıntılar sağlanır.

Bağlı hizmet özellikleri

SharePoint Online Listesi bağlı hizmeti için aşağıdaki özellikler desteklenir:

Özellik	Açıklama	Gerekli
type	tür özelliği şu şekilde ayarlanmalıdır: SharePointOnlineList.	Evet
Siteurl	SharePoint Online site url'si, örneğin. `https://contoso.sharepoint.com/sites/siteName`	Evet
servicePrincipalId	Microsoft Entra Id'de kayıtlı uygulamanın Uygulama (istemci) kimliği. İzin ayarları da dahil olmak üzere diğer ayrıntılar için Önkoşullar bölümüne bakın.	Evet
servicePrincipalKey	Uygulamanın anahtarı. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretleyin veya Azure Key Vault'ta depolanan bir gizli diziye başvurun.	Evet
tenantId	Uygulamanızın bulunduğu kiracı kimliği.	Evet
connectVia	Veri deposuna bağlanmak için kullanılacak Integration Runtime. Belirtilmezse, varsayılan Azure Integration Runtime kullanılır.	No

Örnek:

{
    "name": "SharePointOnlineList",
    "properties": {
        "type": "SharePointOnlineList",
        "typeProperties": {
            "siteUrl": "<site URL>",
            "servicePrincipalId": "<service principal id>",
            "servicePrincipalKey": {
                "type": "SecureString",
                "value": "<service principal key>"
            },
            "tenantId": "<tenant ID>"
        }
    }
}

Veri kümesi özellikleri

Veri kümelerini tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için bkz . Veri kümeleri ve bağlı hizmetler. Aşağıdaki bölümde SAP tablo veri kümesi tarafından desteklenen özelliklerin listesi sağlanır.

Özellik	Açıklama	Gerekli
type	Veri kümesinin tür özelliği SharePointOnlineLResource olarak ayarlanmalıdır.	Evet
listName	SharePoint Online Listesinin adı. Dosya adlarında kesme işaretine (') izin verilmediğini unutmayın.	Evet

Örnek

{
    "name": "SharePointOnlineListDataset",
    "properties":
    {
        "type": "SharePointOnlineListResource",
        "linkedServiceName": {
            "referenceName": "<SharePoint Online List linked service name>",
            "type": "LinkedServiceReference"
        },
        "typeProperties":
        {
            "listName": "<name of the list>"
        }
    }
}

Kopyalama Etkinliği özellikleri

Etkinlikleri tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için bkz . İşlem hatları. Aşağıdaki bölümde, SharePoint Online Liste kaynağı tarafından desteklenen özelliklerin listesi sağlanır.

Kaynak olarak SharePoint Online Listesi

SharePoint Online Listesi'nden veri kopyalamak için Kopyalama Etkinliği kaynağı bölümünde aşağıdaki özellikler desteklenir:

Özellik	Açıklama	Gerekli
type	Kopyalama Etkinliği kaynağının tür özelliği SharePointOnlineListSource olarak ayarlanmalıdır.	Evet
query	Verileri filtrelemek için özel OData sorgu seçenekleri. Örnek: `"$top=10&$select=Title,Number"`.	No
httpRequestTimeout	Yanıt almak için HTTP isteğinin zaman aşımı (ikinci olarak). Varsayılan değer 300'dür (5 dakika).	No

Örnek

"activities":[
    {
        "name": "CopyFromSharePointOnlineList",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SharePoint Online List input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SharePointOnlineListSource",
                "query": "<OData query e.g. $top=10&$select=Title,Number>"
            }, 
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Dekont

SharePoint Online Liste kaynağı için birden fazla seçim veri türü seçmek mümkün değildir.

SharePoint Online Listesi için veri türü eşlemesi

SharePoint Online Listesi'nden veri kopyaladığınızda, SharePoint Online Listesi veri türleri ile hizmet tarafından dahili olarak kullanılan ara veri türleri arasında aşağıdaki eşlemeler kullanılır.

SharePoint Online veri türü	OData veri türü	Ara veri türü
Tek satır metin	Edm.String	String
Birden çok metin satırı	Edm.String	String
Seçim (seçim yapılacak menü)	Edm.String	String
Sayı (1, 1,0, 100)	Edm.Double	Çift
Para birimi ($, ¥, €)	Edm.Double	Çift
Tarih ve Saat	Edm.DateTime	DateTime
Arama (zaten bu sitede olan bilgiler)	Edm.Int32	Int32
Evet/Hayır (onay kutusu)	Edm.Boolean	Boolean
Kişi veya Grup	Edm.Int32	Int32
Köprü veya Resim	Edm.String	String
Hesaplanmış (diğer sütunlara göre hesaplama)	Edm.String / Edm.Double / Edm.DateTime / Edm.Boolean	Dize / Çift / DateTime / Boole
Ek	Desteklenmez
Görev Sonucu	Desteklenmez
Dış Veriler	Desteklenmez
Yönetilen Meta Veriler	Desteklenmez

SharePoint Online'dan dosya kopyalama

SPO'dan kimlik doğrulaması yapmak ve erişim belirtecini almak için Web etkinliğini kullanarak SharePoint Online'dan dosya kopyalayabilir ve ardından sonraki Kopyalama etkinliği geçirerek VERILERI HTTP bağlayıcısı ile kaynak olarak kopyalayabilirsiniz.

sharepoint copy file flow

Microsoft Entra uygulaması oluşturmak ve SharePoint Online'a izin vermek için Önkoşullar bölümünü izleyin.
SharePoint Online'dan erişim belirtecini almak için bir Web Etkinliği oluşturun:
- URL: https://accounts.accesscontrol.windows.net/[Tenant-ID]/tokens/OAuth/2. Kiracı kimliğini değiştirin.
- Yöntem: POST
- Üst bilgiler:
  - İçerik Türü: application/x-www-form-urlencoded
- Gövde: grant_type=client_credentials&client_id=[Client-ID]@[Tenant-ID]&client_secret=[Client-Secret]&resource=00000003-0000-0ff1-ce00-000000000000/[Tenant-Name].sharepoint.com@[Tenant-ID]. İstemci kimliğini (uygulama kimliği), istemci gizli dizisini (uygulama anahtarı), kiracı kimliğini ve kiracı adını (SharePoint kiracısının) değiştirin.
Dikkat

Belirteç değerinin düz metin olarak günlüğe kaydedilmesini önlemek için Web etkinliğinde Güvenli Çıkış seçeneğini true olarak ayarlayın. Bu değeri kullanan diğer etkinliklerin Güvenli Giriş seçeneği true olarak ayarlanmalıdır.
SharePoint Online dosya içeriğini kopyalamak için kaynak olarak HTTP bağlayıcısı içeren bir Kopyalama etkinliği zincirleme:
- HTTP bağlı hizmeti:
  - Temel URL: https://[site-url]/_api/web/GetFileByServerRelativeUrl('[relative-path-to-file]')/$value. Site URL'sini ve dosyanın göreli yolunu değiştirin. SharePoint sitesi URL'sini etki alanı adıyla birlikte eklediğinizden emin olun, örneğin https://[sharepoint-domain-name].sharepoint.com/sites/[sharepoint-site]/_api/web/GetFileByServerRelativeUrl('/sites/[sharepoint-site]/[relative-path-to-file]')/$value.
  - Kimlik doğrulama türü: Anonim (daha sonra kopyalama etkinliği kaynağında yapılandırılan Taşıyıcı belirtecini kullanmak için)
- Veri kümesi: İstediğiniz biçimi seçin. Dosyayı olduğu gibi kopyalamak için "İkili" türü'nü seçin.
- Kopyalama etkinliği kaynağı:
  - İstek yöntemi: GET
  - Ek üst bilgi: Yukarı akış Web etkinliği tarafından oluşturulan Taşıyıcı belirtecini yetkilendirme üst bilgisi olarak kullanan aşağıdaki ifadeyi@{concat('Authorization: Bearer ', activity('<Web-activity-name>').output.access_token)} kullanın. Web etkinliği adını değiştirin.
- Kopyalama etkinliği havuzlarını her zamanki gibi yapılandırın.