Azure Data Factory veya Azure Synapse Analytics kullanarak SharePoint Online Listesi'nden veri kopyalama
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!
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/-) | (1) (2) |
Arama etkinliği | (1) (2) |
(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.
İpucu
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.
SharePoint Online site bağlantınızı açın.
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>
Not
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.
Bu uygulama için "Güven" seçeneğine tıklayın.
Kullanmaya başlayın
İşlem hattıyla Kopyalama etkinliği gerçekleştirmek için aşağıdaki araçlardan veya SDK'lardan birini kullanabilirsiniz:
- Veri Kopyalama aracı
- Azure portal
- .NET SDK'sı
- Python SDK'sı
- Azure PowerShell
- The REST API
- Azure Resource Manager şablonu
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:
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ğlayıcı 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 |
---|---|---|
Tür | tür özelliği şu şekilde ayarlanmalıdır: SharePointOnlineList. | Yes |
siteUrl | SharePoint Online site url'si, örneğin. https://contoso.sharepoint.com/sites/siteName |
Yes |
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. | Yes |
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. | Yes |
tenantId | Uygulamanızın bulunduğu kiracı kimliği. | Yes |
connectVia | Veri deposuna bağlanmak için kullanılacak Integration Runtime. Belirtilmezse, varsayılan Azure Integration Runtime kullanılır. | Hayır |
Ö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 |
---|---|---|
Tür | Veri kümesinin tür özelliği SharePointOnlineLResource olarak ayarlanmalıdır. | Yes |
listName | SharePoint Online Listesinin adı. Dosya adlarında kesme işaretine (') izin verilmediğini unutmayın. | Yes |
Ö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 |
---|---|---|
Tür | Kopyalama Etkinliği kaynağının tür özelliği SharePointOnlineListSource olarak ayarlanmalıdır. | Yes |
query | Verileri filtrelemek için özel OData sorgu seçenekleri. Örnek: "$top=10&$select=Title,Number" . |
Hayır |
httpRequestTimeout | Yanıt almak için HTTP isteğinin zaman aşımı (ikinci olarak). Varsayılan değer 300'dür (5 dakika). | Hayır |
Ö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>"
}
}
}
]
Not
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.
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.
- URL:
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ğinhttps://[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)
- Temel URL:
- 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.
- HTTP bağlı hizmeti:
Not
Bir Microsoft Entra uygulamasının FullControl
SharePoint Online üzerinde izinleri olsa bile, IRM'nin etkin olduğu belge kitaplıklarından dosya kopyalayamazsınız.
Arama etkinliği özellikleri
Özellikler hakkında ayrıntılı bilgi edinmek için Arama etkinliği'ne bakın.
İlgili içerik
Kopyalama Etkinliği'nin kaynak ve havuz olarak desteklediği veri depolarının listesi için bkz . Desteklenen veri depoları ve biçimleri.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin