Azure Data Factory veya Synapse Analytics kullanarak Microsoft 365'ten (Office 365) Azure'a kopyalama

Makale
10/30/2024

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!

Azure Data Factory ve Synapse Analytics işlem hatları Microsoft Graph veri bağlantısı ile tümleştirerek Microsoft 365 (Office 365) kiracınızdaki zengin kuruluş verilerini ölçeklenebilir bir şekilde Azure'a getirmenize ve analiz uygulamaları oluşturmanıza ve bu değerli veri varlıklarına dayalı içgörüler elde etmenize olanak tanır. Privileged Access Management ile tümleştirme, Microsoft 365'te (Office 365) seçilmiş değerli veriler için güvenli erişim denetimi sağlar. Microsoft Graph veri bağlantısı genel bakış için bu bağlantıya bakın.

Bu makalede, Verileri kopyalamak için Kopyalama Etkinliği'nin nasıl kullanılacağı ve Microsoft 365'ten (Office 365) veri dönüştürmek için Veri Akışı nasıl kullanılacağı özetlenmiştir. Verileri kopyalamaya giriş için kopyalama etkinliğine genel bakış'ı okuyun. Verileri dönüştürmeye giriş için eşleme veri akışına genel bakış bölümüne bakın.

Not

Microsoft 365 Veri Akışı bağlayıcısı şu anda önizleme aşamasındadır. Katılmak için şu kaydolma formunu kullanın: M365 + Analytics Preview.

Desteklenen özellikler

Bu Microsoft 365 (Office 365) bağlayıcısı aşağıdaki özellikler için desteklenir:

Desteklenen özellikler	IR
Kopyalama etkinliği (kaynak/-)	(1)
Eşleme veri akışı (kaynak/-)	(1)

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

ADF Microsoft 365 (Office 365) bağlayıcısı ve Microsoft Graph Veri Bağlantısı, adres defteri kişileri, takvim olayları, e-posta iletileri, kullanıcı bilgileri, posta kutusu ayarları vb. dahil olmak üzere Exchange E-postası özellikli posta kutularından farklı veri kümelerinin büyük ölçekte alımını sağlar. Kullanılabilir veri kümelerinin tam listesini görmek için buraya bakın.

Şimdilik tek bir kopyalama etkinliği ve veri akışı içinde yalnızca Microsoft 365'ten (Office 365) JSON biçiminde Azure Blob Depolama, Azure Data Lake Storage 1. Nesil ve Azure Data Lake Storage 2. Nesil (setOfObjects türü) veri alabilirsiniz. Azure Blob Depolama kopyaladığınızda çıkış, JSON metni içeren bir blobdur. Microsoft 365'i (Office 365) başka veri depolarına veya başka biçimlerde yüklemek istiyorsanız, desteklenen ADF hedef depolarından herhangi birine daha fazla veri yüklemek için ilk kopyalama etkinliğini veya veri akışını sonraki bir etkinlikle zincirleyebilirsiniz ("Desteklenen veri depoları ve biçimleri" tablosundaki "havuz olarak desteklenir" sütununa bakın).

Önemli

Veri fabrikasını veya Synapse çalışma alanını içeren Azure aboneliği ve havuz veri deposu, Microsoft 365 (Office 365) kiracısı ile aynı Microsoft Entra kiracısı altında olmalıdır.
Kopyalama etkinliği için kullanılan Azure Integration Runtime bölgesinin yanı sıra hedefin Microsoft 365 (Office 365) kiracı kullanıcılarının posta kutusunun bulunduğu bölgede olduğundan emin olun. Azure IR konumunun nasıl belirlendiğini anlamak için buraya bakın. Desteklenen Office bölgelerinin ve ilgili Azure bölgelerinin listesi için buradaki tabloya bakın.
Hizmet Sorumlusu kimlik doğrulaması, hedef depo olarak Azure Blob Depolama, Azure Data Lake Storage 1. Nesil ve Azure Data Lake Storage 2. Nesil için desteklenen tek kimlik doğrulama mekanizmasıdır.

Not

Lütfen hem kaynak hem de havuz bağlantılı hizmetlerde Azure tümleştirme çalışma zamanını kullanın. Şirket içinde barındırılan tümleştirme çalışma zamanı ve yönetilen sanal ağ tümleştirme çalışma zamanı desteklenmez.

Önkoşullar

Microsoft 365'ten (Office 365) Azure'a veri kopyalamak ve dönüştürmek için aşağıdaki önkoşul adımlarını tamamlamanız gerekir:

Microsoft 365 (Office 365) kiracı yöneticinizin burada açıklandığı gibi ekleme eylemlerini tamamlaması gerekir.
Microsoft Entra Id'de bir Microsoft Entra web uygulaması oluşturun ve yapılandırın. Yönergeler için bkz . Microsoft Entra uygulaması oluşturma.
Microsoft 365 (Office 365) için bağlı hizmeti tanımlamak için kullandığınız aşağıdaki değerleri not edin:
- Kiracı Kimliği. Yönergeler için bkz . Kiracı kimliğini alma.
- Uygulama Kimliği ve Uygulama anahtarı. Yönergeler için bkz . Uygulama kimliğini ve kimlik doğrulama anahtarını alma.
Veri erişim isteğinde bulunan kullanıcı kimliğini Microsoft Entra web uygulamasının sahibi olarak ekleyin (Microsoft Entra web uygulaması > Ayarlar > Sahipler > Sahibi Ekle'den).
- Kullanıcı kimliği, veri almakta olduğunuz Microsoft 365 (Office 365) kuruluşunda olmalıdır ve Konuk kullanıcı olmamalıdır.

Yeni veri erişim isteklerini onaylama

Bu bağlam için ilk kez veri isteğinde bulunuyorsanız (erişilmekte olan veri tablosunun bir bileşimi, hangi hedef hesaba yüklenen veriler ve veri erişim isteğinde bulunan kullanıcı kimliği), kopyalama etkinliği durumunu "Sürüyor" olarak görürsünüz ve yalnızca Eylemler'in altındaki "Ayrıntılar" bağlantısına tıkladığınızda durumu "RequestingConsent" olarak görürsünüz. Veri ayıklama işleminin devam etmesi için önce veri erişimi onaylayan grubunun bir üyesinin Privileged Access Management'ta isteği onaylaması gerekir.

Onaylayanın veri erişim isteğini nasıl onaylayabileceğinizi öğrenmek için buraya bakın.

Başlarken

İpucu

Microsoft 365 (Office 365) bağlayıcısını kullanma hakkında izlenecek yol için Bkz . Microsoft 365'ten veri yükleme (Office 365) makalesi.

Aşağıdaki araçlardan veya SDK'lardan birini kullanarak kopyalama etkinliği ve veri akışı ile bir işlem hattı oluşturabilirsiniz. Kopyalama etkinliğine sahip bir işlem hattı oluşturmak için adım adım yönergelerin yer aldığı bir öğreticiye gitmek için bir bağlantı seçin.

Kullanıcı arabirimini kullanarak Microsoft 365'e (Office 365) bağlı hizmet oluşturma

Azure portalı kullanıcı arabiriminde Microsoft 365'e (Office 365) bağlı bir 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
Microsoft 365 (Office 365) araması yapın ve Microsoft 365 (Office 365) 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, Microsoft 365 (Office 365) bağlayıcısına özgü Data Factory varlıklarını tanımlamak için kullanılan özellikler hakkında ayrıntılar sağlanır.

Bağlı hizmet özellikleri

Microsoft 365 (Office 365) 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: Office365	Yes
office365TenantId	Microsoft 365 (Office 365) hesabının ait olduğu Azure kiracı kimliği.	Yes
servicePrincipalTenantId	Microsoft Entra web uygulamanızın bulunduğu kiracı bilgilerini belirtin.	Yes
servicePrincipalId	Uygulamanın istemci kimliğini belirtin.	Yes
servicePrincipalKey	Uygulamanın anahtarını belirtin. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretleyin.	Yes
connectVia	Veri deposuna bağlanmak için kullanılacak Integration Runtime. Belirtilmezse, varsayılan Azure Integration Runtime'ı kullanır.	Hayır

Not

office365TenantId ile servicePrincipalTenantId arasındaki fark ve sağlayabilecek karşılık gelen değer:

Kendi kuruluşunuzun kullanımı için Microsoft 365 (Office 365) verilerine karşı uygulama geliştiren bir kurumsal geliştiriciyseniz, kuruluşunuzun Microsoft Entra kiracı kimliği olan her iki özellik için de aynı kiracı kimliğini sağlamanız gerekir.
Müşterileriniz için uygulama geliştiren bir ISV geliştiricisiyseniz, office365TenantId müşterinizin (uygulama yükleyicisi) Microsoft Entra kiracı kimliği ve servicePrincipalTenantId şirketinizin Microsoft Entra kiracı kimliği olacaktır.

Örnek:

{
    "name": "Office365LinkedService",
    "properties": {
        "type": "Office365",
        "typeProperties": {
            "office365TenantId": "<Microsoft 365 (Office 365) tenant id>",
            "servicePrincipalTenantId": "<AAD app service principal tenant id>",
            "servicePrincipalId": "<AAD app service principal id>",
            "servicePrincipalKey": {
                "type": "SecureString",
                "value": "<AAD app service principal key>"
            }
        }
    }
}

Veri kümesi özellikleri

Veri kümelerini tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için veri kümeleri makalesine bakın. Bu bölümde, Microsoft 365 (Office 365) veri kümesi tarafından desteklenen özelliklerin listesi sağlanır.

Microsoft 365'ten (Office 365) veri kopyalamak için aşağıdaki özellikler desteklenir:

Özellik	Açıklama	Gerekli
Tür	Veri kümesinin tür özelliği şu şekilde ayarlanmalıdır: Office365Table	Yes
tableName	Microsoft 365'ten (Office 365) ayıklanan veri kümesinin adı. Ayıklama için kullanılabilecek Microsoft 365 (Office 365) veri kümelerinin listesi için buraya bakın.	Yes

Veri kümesinde , startTime, endTimeve userScopeFilterUri ayarlıysanızdateFilterColumn, yeni modeli etkinlik kaynağında kullanmanız önerilirken, yine de olduğu gibi desteklenir.

Örnek

{
    "name": "DS_May2019_O365_Message",
    "properties": {
        "type": "Office365Table",
        "linkedServiceName": {
            "referenceName": "<Microsoft 365 (Office 365) linked service name>",
            "type": "LinkedServiceReference"
        },
        "schema": [],
        "typeProperties": {
            "tableName": "BasicDataSet_v0.Event_v1"
        }
    }
}

Kopyalama etkinliğinin özellikleri

Etkinlikleri tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için İşlem hatları makalesine bakın. Bu bölümde, Microsoft 365 (Office 365) kaynağı tarafından desteklenen özelliklerin listesi sağlanır.

Kaynak olarak Microsoft 365 (Office 365)

Microsoft 365'ten (Office 365) 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 type özelliği şu şekilde ayarlanmalıdır: Office365Source	Yes
allowedGroups	Grup seçimi koşulu. Verilerin alınacağı en fazla 10 kullanıcı grubunu seçmek için bu özelliği kullanın. Hiçbir grup belirtilmezse, tüm kuruluş için veriler döndürülür.	Hayır
userScopeFilterUri	Özellik belirtilmediğinde `allowedGroups` , Microsoft 365'ten (Office 365) ayıklanan belirli satırları filtrelemek için kiracının tamamına uygulanan bir koşul ifadesi kullanabilirsiniz. Koşul biçimi, Microsoft Graph API'lerinin sorgu biçimiyle (örneğin) eşleşmelidir. `https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'`	Hayır
dateFilterColumn	DateTime filtre sütununun adı. Microsoft 365 (Office 365) verilerinin ayıklandığı zaman aralığını sınırlamak için bu özelliği kullanın.	Veri kümesinde bir veya daha fazla DateTime sütunu varsa Evet. Bu DateTime filtresini gerektiren veri kümelerinin listesi için buraya bakın.
startTime	Filtre uygulamak için DateTime değerini başlatın.	Belirtildiyse `dateFilterColumn` Evet
endTime	Filtre uygulamak için End DateTime değeri.	Belirtildiyse `dateFilterColumn` Evet
outputColumns	Havuza kopyalanacak sütunların dizisi.	Hayır

Örnek:

"activities": [
    {
        "name": "CopyFromO365ToBlob",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Microsoft 365 (Office 365) input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "Office365Source",
                "dateFilterColumn": "CreatedDateTime",
                "startTime": "2019-04-28T16:00:00.000Z",
                "endTime": "2019-05-05T16:00:00.000Z",
                "userScopeFilterUri": "https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'",
                "outputColumns": [
                    {
                        "name": "Id"
                    },
                    {
                        "name": "CreatedDateTime"
                    },
                    {
                        "name": "LastModifiedDateTime"
                    },
                    {
                        "name": "ChangeKey"
                    },
                    {
                        "name": "Categories"
                    },
                    {
                        "name": "OriginalStartTimeZone"
                    },
                    {
                        "name": "OriginalEndTimeZone"
                    },
                    {
                        "name": "ResponseStatus"
                    },
                    {
                        "name": "iCalUId"
                    },
                    {
                        "name": "ReminderMinutesBeforeStart"
                    },
                    {
                        "name": "IsReminderOn"
                    },
                    {
                        "name": "HasAttachments"
                    },
                    {
                        "name": "Subject"
                    },
                    {
                        "name": "Body"
                    },
                    {
                        "name": "Importance"
                    },
                    {
                        "name": "Sensitivity"
                    },
                    {
                        "name": "Start"
                    },
                    {
                        "name": "End"
                    },
                    {
                        "name": "Location"
                    },
                    {
                        "name": "IsAllDay"
                    },
                    {
                        "name": "IsCancelled"
                    },
                    {
                        "name": "IsOrganizer"
                    },
                    {
                        "name": "Recurrence"
                    },
                    {
                        "name": "ResponseRequested"
                    },
                    {
                        "name": "ShowAs"
                    },
                    {
                        "name": "Type"
                    },
                    {
                        "name": "Attendees"
                    },
                    {
                        "name": "Organizer"
                    },
                    {
                        "name": "WebLink"
                    },
                    {
                        "name": "Attachments"
                    },
                    {
                        "name": "BodyPreview"
                    },
                    {
                        "name": "Locations"
                    },
                    {
                        "name": "OnlineMeetingUrl"
                    },
                    {
                        "name": "OriginalStart"
                    },
                    {
                        "name": "SeriesMasterId"
                    }
                ]
            },
            "sink": {
                "type": "BlobSink"
            }
        }
    }
]

Kopyalama etkinliği tarafından kaynak ve havuz olarak desteklenen veri depolarının listesi için bkz . desteklenen veri depoları.

Aracılığıyla paylaş

Azure Data Factory veya Synapse Analytics kullanarak Microsoft 365'ten (Office 365) Azure'a kopyalama

Desteklenen özellikler

Önkoşullar

Yeni veri erişim isteklerini onaylama

Başlarken

Kullanıcı arabirimini kullanarak Microsoft 365'e (Office 365) bağlı hizmet oluşturma

Bağlayıcı yapılandırma ayrıntıları

Bağlı hizmet özellikleri

Veri kümesi özellikleri

Kopyalama etkinliğinin özellikleri

Kaynak olarak Microsoft 365 (Office 365)

Geri Bildirim

Ek kaynaklar

Aracılığıyla paylaş

Azure Data Factory veya Synapse Analytics kullanarak Microsoft 365'ten (Office 365) Azure'a kopyalama

Desteklenen özellikler

Önkoşullar

Yeni veri erişim isteklerini onaylama

Başlarken

Kullanıcı arabirimini kullanarak Microsoft 365'e (Office 365) bağlı hizmet oluşturma

Bağlayıcı yapılandırma ayrıntıları

Bağlı hizmet özellikleri

Veri kümesi özellikleri

Kopyalama etkinliğinin özellikleri

Kaynak olarak Microsoft 365 (Office 365)

İlgili içerik

Geri Bildirim

Ek kaynaklar