接続の確立

Microsoft Office 365 への接続を追加

Microsoft Office 365 への接続を追加するには：

アプリケーションコンソールで、接続ページに移動します。
接続の追加パネルで、追加したい接続のアイコンを選択します。
Microsoft Office 365 アイコンが利用できない場合は、Add More アイコンをクリックしてCData サイトからMicrosoft Office 365 コネクタをダウンロードおよびインストールします。

必須プロパティについては、設定タブを参照してください。

通常必須ではない接続プロパティについては、高度な設定タブを参照してください。

Microsoft Office 365 への認証

Microsoft Office 365 はOAuth 認証標準を利用しています。OAuth を使って認証するには、アプリケーションを作成してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得する必要があります。

Azure AD

Azure AD は、Microsoft のマルチテナント、クラウドベースのディレクトリおよびID 管理サービスです。これはユーザーベースの認証で、AuthScheme をAzureAD に設定する必要があります。

Web アプリケーションを介したAzure AD への認証には、常にカスタムOAuth アプリケーションの作成が必要です。

カスタムOAuthアプリケーションの作成の詳細については、Azure AD アプリケーションの作成を参照してください。

Azure サービスプリンシパル

Azure サービスプリンシパルは、ロールに基づいたアプリケーションベースの認証です。これは、認証がユーザーごとではなく、アプリケーションごとに行われることを意味します。アプリケーションで実行されるすべてのタスクは、デフォルトユーザーコンテキストなしで、割り当てられたロールに基づいて実行されます。リソースへのアプリケーションのアクセスは、割り当てられたロールの権限によって制御されます。

Azure サービスプリンシパル認証の設定方法については、サービスプリンシパルによるAzure AD アプリの作成を参照してください。

Managed Service Identity (MSI)

Azure VM 上でMicrosoft Office 365 を実行しており、マネージドID（MSI）認証情報を自動的に取得して接続したい場合は、AuthScheme を AzureMSI に設定します。

User-Managed Identities

マネージドID のトークンを取得するには、OAuthClientId プロパティを使用してマネージドID のclient_id を指定します。

VM に複数のユーザーが割り当てられたマネージドID がある場合は、OAuthClientId も指定する必要があります。

管理タスク

CData Sync App を使用して、管理タスクを実行できます。これは、CUD 操作を実行するためにUserId カラムを指定することで行います。

UserId カラム

多くのテーブルは特別なUserId カラムを公開しています。これは、管理者が他のユーザーアカウントのレコードを変更するために使用するようにデザインされています。自分が管理者ではない場合、またはこの動作を望まない場合は、INSERT / UPDATE / DELETE 操作を実行するときにUserId を指定しないでください。例えば、次のコマンドを実行すると、他のユーザーの連絡先が挿入されます。

INSERT INTO Contacts (displayName, CompanyName, UserId) VALUES ('Bill', 'Bob Co', '12345')

上記のリクエストは、/users/12345/contacts のリソースの下に連絡先を追加しようとする全体的な効果があります。UserId が指定されていない場合、影響を受けるリソースは代わりに/users/me/contacts の下に変更されます。一般的に、管理者でない場合は/users/me 下のレコードにしか影響を与えたり表示したりできないので、管理者でない場合はUserId を設定することはお勧めできません。

高度な機能

このセクションでは、Microsoft Office 365 Sync App の高度な機能を厳選して説明します。

ユーザー定義ビュー

Sync App はユーザー定義ビューの使用をサポートします。これは事前設定されたユーザー定義クエリによって内容が決定される仮想テーブルです。このビューは、ドライバーに発行されるクエリを直接制御できない場合に有効です。カスタムビューの作成と設定の概要については、ユーザー定義ビューを参照してください。

SSL の設定

SSL の設定を使用して、Sync App が証明書のネゴシエーションをどのように扱うかを調整します。さまざまな証明書形式を選択できます。詳しくは、「接続文字列オプション」にあるSSLServerCert プロパティを参照してください。

ファイアウォールとプロキシ

Windows プロキシとHTTP プロキシを含むファイアウォールとプロキシに合致するようSync App を設定します。トンネル接続を設定することもできます。

クエリ処理

Sync App は、Microsoft Office 365 にできるだけ多くのSELECT ステートメント処理をオフロードし、残りのクエリをクライアント側のインメモリで処理します。

詳しくは、クエリ処理を参照してください。

ログ

CData ログを調整するために使用可能な設定の概要については、ログを参照してください。基本的なロギングに必要なのは2つの接続プロパティだけですが、より詳細なロギングをサポートする多くの機能があり、LogModules 接続プロパティを使用してロギングする情報のサブセットを指定することができます。

SSL の設定

SSL 設定のカスタマイズ

デフォルトでは、Sync App はサーバーとのTLS のネゴシエーションを試みます。サーバー証明書は、デフォルトのシステム信頼済み証明書ストアで検証されます。SSLServerCert 接続プロパティを使用して、証明書の検証方法をオーバーライドできます。

別の証明書を指定するには、SSLServerCert 接続プロパティを参照してください。

ファイアウォールとプロキシ

Firewall またはProxy 経由の接続

HTTP プロキシ

HTTP プロキシへの認証には、以下のように設定します。

ProxyServer：HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
ProxyPort：プロキシサーバーが起動しているTCP ポート。
ProxyAuthScheme：プロキシサーバーに対して認証する際にSync App が使用する認証方法。
ProxyUser：プロキシサーバーに登録されているユーザーアカウントのユーザー名。
ProxyPassword：ProxyUser に紐付けられたパスワード。

その他のプロキシ

次のプロパティを設定します。

プロキシベースのファイヤーウォールを使用するには、FirewallType、FirewallServer、およびFirewallPort を設定します。
接続をトンネルするには、FirewallType をTUNNEL に設定します。
認証するには、FirewallUser とFirewallPassword を設定します。
SOCKS プロキシへの認証には、さらにFirewallType をSOCKS5 に設定します。

データモデル

Sync App はMicrosoft Office 365 API をリレーショナルテーブルとしてモデル化します。リモートデータへのあらゆる変更はクエリに即時に反映されます。テーブル定義は動的に取得されます。接続すると、Sync App はMicrosoft Office 365 に接続し、適切なWeb サービスを呼び出してテーブルのリストとテーブルのメタデータを取得します。

このセクションでは、API の制限および要件について説明します。既定のSupportEnhancedSQL 機能を使って、これらの制限の大半を回避できます。

テーブル

テーブルは、サンプルOffice 365 サイトの定義を示します。実際のデータモデルは、ユーザー資格情報とOffice 365サイトに基づいて動的に取得されます。

ストアドプロシージャ

ストアドプロシージャは、Office 365のファンクションライクなインターフェースです。これらを使用して、Office365内の情報を検索、更新、および変更できます。

テーブル

Sync App はMicrosoft Office 365 のデータを、標準のSQL ステートメントを使用してクエリできるリレーショナルデータベースのテーブルのリストとしてモデル化します。

Microsoft Office 365 Connector for CData Sync テーブル


Name	Description
Calendars	This table is dynamic and maps to the corresponding field in the API.
Contacts	The Office365 table Contacts.
Conversations	The Office365 table Conversations.
Events	This field is dynamic and maps to the corresponding field in the API.
Files	The Office365 table Files.
Groups	The Office365 table Groups.
Messages	The Office365 table Messages.
Tasks	The Office365 table Tasks.
Users	Read, Insert, Update and Delete a User.

Calendars

This table is dynamic and maps to the corresponding field in the API.

Table Specific Information

Select

You can query Calendars by specifying an Id or selecting all:

SELECT * FROM Calendars WHERE Id = 'your Calendar Id goes here'

Select a certain column from the entity and filter by that column:

SELECT id FROM Calendars WHERE name LIKE 'Calendar%'

Insert

Specify a Name as a minimum in order to create a new Calendar:

INSERT INTO Calendars (Name) VALUES ('John')

Note: In case of client credentials, UserId is required in order to create a new Calendar:

INSERT INTO Calendars (Name, UserId) VALUES ('Test123', '92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe');

Columns


Name	Type	ReadOnly	References	Description
id [KEY]	String	True		This field is dynamic and maps to the corresponding field in the API.
Etag	String	False		This field is dynamic and maps to the corresponding field in the API.
allowedOnlineMeetingProviders	String	False		This field is dynamic and maps to the corresponding field in the API.
canEdit	Bool	False		This field is dynamic and maps to the corresponding field in the API.
canShare	Bool	False		This field is dynamic and maps to the corresponding field in the API.
canViewPrivateItems	Bool	False		This field is dynamic and maps to the corresponding field in the API.
changeKey	String	False		This field is dynamic and maps to the corresponding field in the API.
color	String	False		This field is dynamic and maps to the corresponding field in the API.
defaultOnlineMeetingProvider	String	False		This field is dynamic and maps to the corresponding field in the API.
hexColor	String	False		This field is dynamic and maps to the corresponding field in the API.
isDefaultCalendar	Bool	False		This field is dynamic and maps to the corresponding field in the API.
isRemovable	Bool	False		This field is dynamic and maps to the corresponding field in the API.
isTallyingResponses	Bool	False		This field is dynamic and maps to the corresponding field in the API.
name	String	False		This field is dynamic and maps to the corresponding field in the API.
owner_address	String	False		This field is dynamic and maps to the corresponding field in the API.
owner_name	String	False		This field is dynamic and maps to the corresponding field in the API.
UserId [KEY]	String	False		The UserId column for the table Calendars.

Contacts

The Office365 table Contacts.

テーブル固有の情報

Select

Id を指定するかすべてを選択することで、Contacts をクエリできます。

SELECT * FROM Contacts WHERE Id = 'your Contact Id goes here'

エンティティから特定のカラムを選択して、そのカラムでフィルタします。

SELECT GivenName FROM Contacts WHERE GivenName LIKE 'John%'

Insert

新しいContact を作成するには、GivenName とSurname を最低限に指定します。

INSERT INTO Contacts (GivenName, Surname) VALUES ('John', 'Smith')

Note: In case of client credentials, UserId is required in order to create a new Contact:

INSERT INTO Contacts (GivenName, Surname, UserId) VALUES ('John', 'Smith', '92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe')

Columns


Name	Type	ReadOnly	References	Description
id [KEY]	String	True		The contact's unique identifier.
Etag	String	False
categories	String	False		The categories associated with the contact.
changeKey	String	False		Identifies the version of the contact. This changes every time the contact is changed.
createdDateTime	Datetime	False		The time the contact was created.
lastModifiedDateTime	Datetime	False		The time the contact was last modified.
assistantName	String	False		The name of the contact's assistant.
birthday	Datetime	False		The contact's birthday.
businessAddress_city	String	False		The city of the contact's business address.
businessAddress_countryOrRegion	String	False		The country or region of the contact's business address.
businessAddress_postalCode	String	False		The postal code of the contact's business address.
businessAddress_state	String	False		The state of the contact's business address.
businessAddress_street	String	False		The street of the contact's business address.
businessHomePage	String	False		The business home page of the contact.
businessPhones	String	False		The contact's business phone numbers.
children	String	False		The names of the contact's children.
companyName	String	False		The name of the contact's company.
department	String	False		The department of the contact.
displayName	String	False		The contact's display name.
emailAddresses	String	False		A collection of email address associated with the contact.
fileAs	String	False		The name the contact is filed under.
generation	String	False		The generation of the contact.
givenName	String	False		The given name of the contact.
homeAddress_city	String	False		The city of the contact's home address.
homeAddress_countryOrRegion	String	False		The country or region of the contact's home address.
homeAddress_postalCode	String	False		The postal code of the contact's home address.
homeAddress_state	String	False		The state of the contact's home address.
homeAddress_street	String	False		The street of the contact's home address.
homePhones	String	False		The contact's home phone numbers
imAddresses	String	False		The contact's instant messaging (IM) address.
initials	String	False		The initials of the contact.
jobTitle	String	False		The contact's job title.
manager	String	False		The name of the contact's manager.
middleName	String	False		The contact's middle name.
mobilePhone	String	False		The mobile phone number of the contact.
nickName	String	False		The contact's nickname.
officeLocation	String	False		The location of the contact's address.
otherAddress_city	String	False		The city of the customer's other address.
otherAddress_countryOrRegion	String	False		The country or region of the customer's other address.
otherAddress_postalCode	String	False		The postal code of the customer's other address
otherAddress_state	String	False		The state of the customer's other address.
otherAddress_street	String	False		The street of the customer's other address.
parentFolderId	String	False		The ID of the contact's parent folder.
personalNotes	String	False		The user's notes about the contact.
profession	String	False		The contact's profession.
spouseName	String	False		The name of the contact's spouse/partner.
surname	String	False		The contact's surname.
title	String	False		The contact's title.
yomiCompanyName	String	False		The phonetic Japanese company name of the contact.
yomiGivenName	String	False		The phonetic Japanese given name (first name) of the contact.
yomiSurname	String	False		The phonetic Japanese surname (last name) of the contact.
UserId [KEY]	String	False		The contact's user ID.

Conversations

The Office365 table Conversations.

テーブル固有の情報

Select

グループConversations を取得するには、GroupId が必要です

SELECT * FROM Conversations WHERE GroupId = 'your GroupId goes here'

また、GroupId とConversation Id を使ってグループConversations を取得することもできます。

SELECT * FROM Conversations WHERE Id = 'conversation Id here' AND GroupId = 'your GroupId goes here'

Insert

新しいConversation を作成するには、GroupId、Topic、Content、およびNewParticipants を指定します。NewParticipants は複合型です。フォーマットは次のとおりです：'name1, email1; name2, email2'。

INSERT INTO Conversations (GroupId, Topic, Content, NewParticipants) VALUES ('GroupId here', 'This is a test topic.', 'Hi, How Are you?', 'someone, [email protected]')

Columns


Name	Type	ReadOnly	References	Description
id [KEY]	String	True		The id column for the table Conversations.
Etag	String	False
hasAttachments	Bool	False		The hasAttachments column for the table Conversations.
lastDeliveredDateTime	Datetime	False		The lastDeliveredDateTime column for the table Conversations.
preview	String	False		The preview column for the table Conversations.
topic	String	False		The topic column for the table Conversations.
uniqueSenders	String	False		The uniqueSenders column for the table Conversations.
GroupId [KEY]	String	False		The GroupId column for the table Conversations.
Content	String	False		The Content column for the table Conversations.
NewParticipants	String	False		The NewParticipants column for the table Conversations.

Events

This field is dynamic and maps to the corresponding field in the API.

テーブル固有の情報

Select

イベントを返すにはデフォルトで'me' プロパティが使用されます。

Events を検索するときにWHERE 句のUserId を使用してこれをオーバーライドできます。

SELECT * FROM Events WHERE UserId = 'abc123' AND Subject LIKE '%test%'

GroupId にはカレンダータイプのId またはグループId を指定できます。例：

SELECT * FROM Events WHERE GroupId = 'enter your group Id here'

Insert

新しいイベントを作成するには、タイムゾーンを含むstart とend が必須です。

INSERT INTO Events (Subject, Body_Content, Start_DateTime, Start_TimeZone, End_DateTime, End_TimeZone) VALUES ('New Test Event', 'Event created using Office365Provider', '2016-01-01T10:00:00', 'UTC', '2016-01-01T11:00:00', 'UTC')

Note：デフォルトで、このステートメントはイベントをデフォルトカレンダー内に作成します。

Note: In case of client credentials, UserId is required in order to create a new Event:

INSERT INTO Events (Subject, Body_Content, Start_DateTime, Start_TimeZone, End_DateTime, End_TimeZone, UserId) VALUES ('New Test Event', 'Event created using Office365Provider', '2016-01-01T10:00:00', 'UTC', '2016-01-01T11:00:00', 'UTC', '92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe')

Columns


Name	Type	ReadOnly	References	Description
id [KEY]	String	True		This field is dynamic and maps to the corresponding field in the API.
Etag	String	False		This field is dynamic and maps to the corresponding field in the API.
categories	String	False		This field is dynamic and maps to the corresponding field in the API.
changeKey	String	False		This field is dynamic and maps to the corresponding field in the API.
createdDateTime	Datetime	False		This field is dynamic and maps to the corresponding field in the API.
lastModifiedDateTime	Datetime	False		This field is dynamic and maps to the corresponding field in the API.
allowNewTimeProposals	Bool	False		This field is dynamic and maps to the corresponding field in the API.
attendees	String	False		This field is dynamic and maps to the corresponding field in the API.
body_content	String	False		This field is dynamic and maps to the corresponding field in the API.
body_contentType	String	False		This field is dynamic and maps to the corresponding field in the API.
bodyPreview	String	False		This field is dynamic and maps to the corresponding field in the API.
end_dateTime	Datetime	False		This field is dynamic and maps to the corresponding field in the API.
end_timeZone	String	False		This field is dynamic and maps to the corresponding field in the API.
hasAttachments	Bool	False		This field is dynamic and maps to the corresponding field in the API.
hideAttendees	Bool	False		This field is dynamic and maps to the corresponding field in the API.
iCalUId	String	False		This field is dynamic and maps to the corresponding field in the API.
importance	String	False		This field is dynamic and maps to the corresponding field in the API.
isAllDay	Bool	False		This field is dynamic and maps to the corresponding field in the API.
isCancelled	Bool	False		This field is dynamic and maps to the corresponding field in the API.
isDraft	Bool	False		This field is dynamic and maps to the corresponding field in the API.
isOnlineMeeting	Bool	False		This field is dynamic and maps to the corresponding field in the API.
isOrganizer	Bool	False		This field is dynamic and maps to the corresponding field in the API.
isReminderOn	Bool	False		This field is dynamic and maps to the corresponding field in the API.
location_address_city	String	False		This field is dynamic and maps to the corresponding field in the API.
location_address_countryOrRegion	String	False		This field is dynamic and maps to the corresponding field in the API.
location_address_postalCode	String	False		This field is dynamic and maps to the corresponding field in the API.
location_address_state	String	False		This field is dynamic and maps to the corresponding field in the API.
location_address_street	String	False		This field is dynamic and maps to the corresponding field in the API.
location_coordinates_accuracy	Double	False		This field is dynamic and maps to the corresponding field in the API.
location_coordinates_altitude	Double	False		This field is dynamic and maps to the corresponding field in the API.
location_coordinates_altitudeAccuracy	Double	False		This field is dynamic and maps to the corresponding field in the API.
location_coordinates_latitude	Double	False		This field is dynamic and maps to the corresponding field in the API.
location_coordinates_longitude	Double	False		This field is dynamic and maps to the corresponding field in the API.
location_displayName	String	False		This field is dynamic and maps to the corresponding field in the API.
location_locationEmailAddress	String	False		This field is dynamic and maps to the corresponding field in the API.
location_locationType	String	False		This field is dynamic and maps to the corresponding field in the API.
location_locationUri	String	False		This field is dynamic and maps to the corresponding field in the API.
location_uniqueId	String	False		This field is dynamic and maps to the corresponding field in the API.
location_uniqueIdType	String	False		This field is dynamic and maps to the corresponding field in the API.
locations	String	False		This field is dynamic and maps to the corresponding field in the API.
onlineMeeting_conferenceId	String	False		This field is dynamic and maps to the corresponding field in the API.
onlineMeeting_joinUrl	String	False		This field is dynamic and maps to the corresponding field in the API.
onlineMeeting_phones	String	False		This field is dynamic and maps to the corresponding field in the API.
onlineMeeting_quickDial	String	False		This field is dynamic and maps to the corresponding field in the API.
onlineMeeting_tollFreeNumbers	String	False		This field is dynamic and maps to the corresponding field in the API.
onlineMeeting_tollNumber	String	False		This field is dynamic and maps to the corresponding field in the API.
onlineMeetingProvider	String	False		This field is dynamic and maps to the corresponding field in the API.
onlineMeetingUrl	String	False		This field is dynamic and maps to the corresponding field in the API.
organizer_emailAddress_address	String	False		This field is dynamic and maps to the corresponding field in the API.
organizer_emailAddress_name	String	False		This field is dynamic and maps to the corresponding field in the API.
originalEndTimeZone	String	False		This field is dynamic and maps to the corresponding field in the API.
originalStart	Datetime	False		This field is dynamic and maps to the corresponding field in the API.
originalStartTimeZone	String	False		This field is dynamic and maps to the corresponding field in the API.
recurrence_pattern_dayOfMonth	Int	False		This field is dynamic and maps to the corresponding field in the API.
recurrence_pattern_daysOfWeek	String	False		This field is dynamic and maps to the corresponding field in the API.
recurrence_pattern_firstDayOfWeek	String	False		This field is dynamic and maps to the corresponding field in the API.
recurrence_pattern_index	String	False		This field is dynamic and maps to the corresponding field in the API.
recurrence_pattern_interval	Int	False		This field is dynamic and maps to the corresponding field in the API.
recurrence_pattern_month	Int	False		This field is dynamic and maps to the corresponding field in the API.
recurrence_pattern_type	String	False		This field is dynamic and maps to the corresponding field in the API.
recurrence_range_endDate	Datetime	False		This field is dynamic and maps to the corresponding field in the API.
recurrence_range_numberOfOccurrences	Int	False		This field is dynamic and maps to the corresponding field in the API.
recurrence_range_recurrenceTimeZone	String	False		This field is dynamic and maps to the corresponding field in the API.
recurrence_range_startDate	Datetime	False		This field is dynamic and maps to the corresponding field in the API.
recurrence_range_type	String	False		This field is dynamic and maps to the corresponding field in the API.
reminderMinutesBeforeStart	Int	False		This field is dynamic and maps to the corresponding field in the API.
responseRequested	Bool	False		This field is dynamic and maps to the corresponding field in the API.
responseStatus_response	String	False		This field is dynamic and maps to the corresponding field in the API.
responseStatus_time	Datetime	False		This field is dynamic and maps to the corresponding field in the API.
sensitivity	String	False		This field is dynamic and maps to the corresponding field in the API.
seriesMasterId	String	False		This field is dynamic and maps to the corresponding field in the API.
showAs	String	False		This field is dynamic and maps to the corresponding field in the API.
start_dateTime	Datetime	False		This field is dynamic and maps to the corresponding field in the API.
start_timeZone	String	False		This field is dynamic and maps to the corresponding field in the API.
subject	String	False		This field is dynamic and maps to the corresponding field in the API.
transactionId	String	False		This field is dynamic and maps to the corresponding field in the API.
type	String	False		This field is dynamic and maps to the corresponding field in the API.
webLink	String	False		This field is dynamic and maps to the corresponding field in the API.
UserId	String	False		This field is dynamic and maps to the corresponding field in the API.
GroupId	String	False		This field is dynamic and maps to the corresponding field in the API.

Files

The Office365 table Files.

テーブル固有の情報

Select

例えばUserId やFile Id (Id) を使ってファイルを取得したり、単純に特定のカラムでフィルタしたりします。

SELECT * FROM Files WHERE UserId = 'MyUserId'

SELECT Name, LastModifiedDateTime FROM Files WHERE Name LIKE 'test%'

フォルダレベルのファイルに対応するには、クエリでparentReference_path を指定する必要があります。

 
SELECT * FROM files WHERE parentReference_path = '/drives/b!3LIvU2zISEqicGlWkgVknKxKT-q7gM5IqlBJ4w4MZqaX6BQc_vtwQpnqaldXkH9I/root:/Test_Shubham';

INSERT

INSERT 操作は、このテーブルではサポートされていません。

Note：ファイルの内容を挿入および更新するには、UploadFile を（フォルダを作成するにはCreateFolder を）参照してください。

Columns


Name	Type	ReadOnly	References	Description
id [KEY]	String	True		The id column for the table Files.
Etag	String	False		The Etag column for the table Files.
createdBy_application_displayName	String	False		The createdBy_application_displayName column for the table Files.
createdBy_application_id	String	False		The createdBy_application_id column for the table Files.
createdDateTime	Datetime	False		The createdDateTime column for the table Files.
description	String	False		The description column for the table Files.
lastModifiedBy_application_displayName	String	False		The lastModifiedBy_application_displayName column for the table Files.
lastModifiedBy_application_id	String	False		The lastModifiedBy_application_id column for the table Files.
lastModifiedDateTime	Datetime	False		The lastModifiedDateTime column for the table Files.
name	String	False		The name column for the table Files.
parentReference_driveId	String	False		The parentReference_driveId column for the table Files.
parentReference_driveType	String	False		The parentReference_driveType column for the table Files.
parentReference_id	String	False		The parentReference_id column for the table Files.
parentReference_name	String	False		The parentReference_name column for the table Files.
parentReference_path	String	False		The parentReference_path column for the table Files.
parentReference_shareId	String	False		The parentReference_shareId column for the table Files.
parentReference_sharepointIds_listId	String	False		The parentReference_sharepointIds_listId column for the table Files.
parentReference_sharepointIds_listItemId	String	False		The parentReference_sharepointIds_listItemId column for the table Files.
parentReference_sharepointIds_listItemUniqueId	String	False		The parentReference_sharepointIds_listItemUniqueId column for the table Files.
parentReference_sharepointIds_siteId	String	False		The parentReference_sharepointIds_siteId column for the table Files.
parentReference_sharepointIds_siteUrl	String	False		The parentReference_sharepointIds_siteUrl column for the table Files.
parentReference_sharepointIds_tenantId	String	False		The parentReference_sharepointIds_tenantId column for the table Files.
parentReference_sharepointIds_webId	String	False		The parentReference_sharepointIds_webId column for the table Files.
parentReference_siteId	String	False		The parentReference_siteId column for the table Files.
webUrl	String	False		The webUrl column for the table Files.
audio_album	String	False		The audio_album column for the table Files.
audio_albumArtist	String	False		The audio_albumArtist column for the table Files.
audio_artist	String	False		The audio_artist column for the table Files.
audio_bitrate	Long	False		The audio_bitrate column for the table Files.
audio_composers	String	False		The audio_composers column for the table Files.
audio_copyright	String	False		The audio_copyright column for the table Files.
audio_disc	Int	False		The audio_disc column for the table Files.
audio_discCount	Int	False		The audio_discCount column for the table Files.
audio_duration	Long	False		The audio_duration column for the table Files.
audio_genre	String	False		The audio_genre column for the table Files.
audio_hasDrm	Bool	False		The audio_hasDrm column for the table Files.
audio_isVariableBitrate	Bool	False		The audio_isVariableBitrate column for the table Files.
audio_title	String	False		The audio_title column for the table Files.
audio_track	Int	False		The audio_track column for the table Files.
audio_trackCount	Int	False		The audio_trackCount column for the table Files.
audio_year	Int	False		The audio_year column for the table Files.
content	String	False		The content column for the table Files.
cTag	String	False		The cTag column for the table Files.
deleted_state	String	False		The deleted_state column for the table Files.
file_hashes_crc32Hash	String	False		The file_hashes_crc32Hash column for the table Files.
file_hashes_quickXorHash	String	False		The file_hashes_quickXorHash column for the table Files.
file_hashes_sha1Hash	String	False		The file_hashes_sha1Hash column for the table Files.
file_hashes_sha256Hash	String	False		The file_hashes_sha256Hash column for the table Files.
file_mimeType	String	False		The file_mimeType column for the table Files.
file_processingMetadata	Bool	False		The file_processingMetadata column for the table Files.
fileSystemInfo_createdDateTime	Datetime	False		The fileSystemInfo_createdDateTime column for the table Files.
fileSystemInfo_lastAccessedDateTime	Datetime	False		The fileSystemInfo_lastAccessedDateTime column for the table Files.
fileSystemInfo_lastModifiedDateTime	Datetime	False		The fileSystemInfo_lastModifiedDateTime column for the table Files.
folder_childCount	Int	False		The folder_childCount column for the table Files.
folder_view_sortBy	String	False		The folder_view_sortBy column for the table Files.
folder_view_sortOrder	String	False		The folder_view_sortOrder column for the table Files.
folder_view_viewType	String	False		The folder_view_viewType column for the table Files.
image_height	Int	False		The image_height column for the table Files.
image_width	Int	False		The image_width column for the table Files.
location_altitude	Double	False		The location_altitude column for the table Files.
location_latitude	Double	False		The location_latitude column for the table Files.
location_longitude	Double	False		The location_longitude column for the table Files.
package_type	String	False		The package_type column for the table Files.
pendingOperations_pendingContentUpdate_queuedDateTime	Datetime	False		The pendingOperations_pendingContentUpdate_queuedDateTime column for the table Files.
photo_cameraMake	String	False		The photo_cameraMake column for the table Files.
photo_cameraModel	String	False		The photo_cameraModel column for the table Files.
photo_exposureDenominator	Double	False		The photo_exposureDenominator column for the table Files.
photo_exposureNumerator	Double	False		The photo_exposureNumerator column for the table Files.
photo_fNumber	Double	False		The photo_fNumber column for the table Files.
photo_focalLength	Double	False		The photo_focalLength column for the table Files.
photo_iso	Int	False		The photo_iso column for the table Files.
photo_orientation	Int	False		The photo_orientation column for the table Files.
photo_takenDateTime	Datetime	False		The photo_takenDateTime column for the table Files.
publication_level	String	False		The publication_level column for the table Files.
publication_versionId	String	False		The publication_versionId column for the table Files.
remoteItem_createdBy_application_displayName	String	False		The remoteItem_createdBy_application_displayName column for the table Files.
remoteItem_createdBy_application_id	String	False		The remoteItem_createdBy_application_id column for the table Files.
remoteItem_createdDateTime	Datetime	False		The remoteItem_createdDateTime column for the table Files.
remoteItem_file_hashes_crc32Hash	String	False		The remoteItem_file_hashes_crc32Hash column for the table Files.
remoteItem_file_hashes_quickXorHash	String	False		The remoteItem_file_hashes_quickXorHash column for the table Files.
remoteItem_file_hashes_sha1Hash	String	False		The remoteItem_file_hashes_sha1Hash column for the table Files.
remoteItem_file_hashes_sha256Hash	String	False		The remoteItem_file_hashes_sha256Hash column for the table Files.
remoteItem_file_mimeType	String	False		The remoteItem_file_mimeType column for the table Files.
remoteItem_file_processingMetadata	Bool	False		The remoteItem_file_processingMetadata column for the table Files.
remoteItem_fileSystemInfo_createdDateTime	Datetime	False		The remoteItem_fileSystemInfo_createdDateTime column for the table Files.
remoteItem_fileSystemInfo_lastAccessedDateTime	Datetime	False		The remoteItem_fileSystemInfo_lastAccessedDateTime column for the table Files.
remoteItem_fileSystemInfo_lastModifiedDateTime	Datetime	False		The remoteItem_fileSystemInfo_lastModifiedDateTime column for the table Files.
remoteItem_folder_childCount	Int	False		The remoteItem_folder_childCount column for the table Files.
remoteItem_folder_view_sortBy	String	False		The remoteItem_folder_view_sortBy column for the table Files.
remoteItem_folder_view_sortOrder	String	False		The remoteItem_folder_view_sortOrder column for the table Files.
remoteItem_folder_view_viewType	String	False		The remoteItem_folder_view_viewType column for the table Files.
remoteItem_id	String	False		The remoteItem_id column for the table Files.
remoteItem_image_height	Int	False		The remoteItem_image_height column for the table Files.
remoteItem_image_width	Int	False		The remoteItem_image_width column for the table Files.
remoteItem_lastModifiedDateTime	Datetime	False		The remoteItem_lastModifiedDateTime column for the table Files.
remoteItem_name	String	False		The remoteItem_name column for the table Files.
remoteItem_package_type	String	False		The remoteItem_package_type column for the table Files.
remoteItem_parentReference_driveId	String	False		The remoteItem_parentReference_driveId column for the table Files.
remoteItem_parentReference_driveType	String	False		The remoteItem_parentReference_driveType column for the table Files.
remoteItem_parentReference_id	String	False		The remoteItem_parentReference_id column for the table Files.
remoteItem_parentReference_name	String	False		The remoteItem_parentReference_name column for the table Files.
remoteItem_parentReference_path	String	False		The remoteItem_parentReference_path column for the table Files.
remoteItem_parentReference_shareId	String	False		The remoteItem_parentReference_shareId column for the table Files.
remoteItem_parentReference_sharepointIds_listId	String	False		The remoteItem_parentReference_sharepointIds_listId column for the table Files.
remoteItem_parentReference_sharepointIds_listItemId	String	False		The remoteItem_parentReference_sharepointIds_listItemId column for the table Files.
remoteItem_parentReference_sharepointIds_listItemUniqueId	String	False		The remoteItem_parentReference_sharepointIds_listItemUniqueId column for the table Files.
remoteItem_parentReference_sharepointIds_siteId	String	False		The remoteItem_parentReference_sharepointIds_siteId column for the table Files.
remoteItem_parentReference_sharepointIds_siteUrl	String	False		The remoteItem_parentReference_sharepointIds_siteUrl column for the table Files.
remoteItem_parentReference_sharepointIds_tenantId	String	False		The remoteItem_parentReference_sharepointIds_tenantId column for the table Files.
remoteItem_parentReference_sharepointIds_webId	String	False		The remoteItem_parentReference_sharepointIds_webId column for the table Files.
remoteItem_parentReference_siteId	String	False		The remoteItem_parentReference_siteId column for the table Files.
remoteItem_shared_scope	String	False		The remoteItem_shared_scope column for the table Files.
remoteItem_shared_sharedDateTime	Datetime	False		The remoteItem_shared_sharedDateTime column for the table Files.
remoteItem_size	Long	False		The remoteItem_size column for the table Files.
remoteItem_specialFolder_name	String	False		The remoteItem_specialFolder_name column for the table Files.
remoteItem_video_audioBitsPerSample	Int	False		The remoteItem_video_audioBitsPerSample column for the table Files.
remoteItem_video_audioChannels	Int	False		The remoteItem_video_audioChannels column for the table Files.
remoteItem_video_audioSamplesPerSecond	Int	False		The remoteItem_video_audioSamplesPerSecond column for the table Files.
remoteItem_video_bitrate	Int	False		The remoteItem_video_bitrate column for the table Files.
remoteItem_video_duration	Long	False		The remoteItem_video_duration column for the table Files.
remoteItem_video_fourCC	String	False		The remoteItem_video_fourCC column for the table Files.
remoteItem_video_frameRate	Double	False		The remoteItem_video_frameRate column for the table Files.
remoteItem_video_height	Int	False		The remoteItem_video_height column for the table Files.
remoteItem_video_width	Int	False		The remoteItem_video_width column for the table Files.
remoteItem_webDavUrl	String	False		The remoteItem_webDavUrl column for the table Files.
remoteItem_webUrl	String	False		The remoteItem_webUrl column for the table Files.
searchResult_onClickTelemetryUrl	String	False		The searchResult_onClickTelemetryUrl column for the table Files.
shared_owner_application_displayName	String	False		The shared_owner_application_displayName column for the table Files.
shared_owner_application_id	String	False		The shared_owner_application_id column for the table Files.
shared_scope	String	False		The shared_scope column for the table Files.
shared_sharedDateTime	Datetime	False		The shared_sharedDateTime column for the table Files.
sharepointIds_listId	String	False		The sharepointIds_listId column for the table Files.
sharepointIds_listItemId	String	False		The sharepointIds_listItemId column for the table Files.
sharepointIds_listItemUniqueId	String	False		The sharepointIds_listItemUniqueId column for the table Files.
sharepointIds_siteId	String	False		The sharepointIds_siteId column for the table Files.
sharepointIds_siteUrl	String	False		The sharepointIds_siteUrl column for the table Files.
sharepointIds_tenantId	String	False		The sharepointIds_tenantId column for the table Files.
sharepointIds_webId	String	False		The sharepointIds_webId column for the table Files.
size	Long	False		The size column for the table Files.
specialFolder_name	String	False		The specialFolder_name column for the table Files.
video_audioBitsPerSample	Int	False		The video_audioBitsPerSample column for the table Files.
video_audioChannels	Int	False		The video_audioChannels column for the table Files.
video_audioFormat	String	False		The video_audioFormat column for the table Files.
video_audioSamplesPerSecond	Int	False		The video_audioSamplesPerSecond column for the table Files.
video_bitrate	Int	False		The video_bitrate column for the table Files.
video_duration	Long	False		The video_duration column for the table Files.
video_fourCC	String	False		The video_fourCC column for the table Files.
video_frameRate	Double	False		The video_frameRate column for the table Files.
video_height	Int	False		The video_height column for the table Files.
video_width	Int	False		The video_width column for the table Files.
webDavUrl	String	False		The webDavUrl column for the table Files.
UserId	String	False		The UserId column for the table Files.

Groups

The Office365 table Groups.

テーブル固有の情報

Groups には管理者権限が必要です。それらを使用するには、独自のカスタムOAuth アプリを作成して、適切なOAuthClientId とOAuthClientSecret を設定する必要があります。このアプリでは、Group.Read.All とGroup.ReadWrite.All の権限をリクエストするように設定する必要があります。これは、https://apps.dev.microsoft.com またはhttp://portal.azure.com の［App Registrations］パネルで設定できます。カスタムアプリの作成に関する詳細は、Azure AD アプリケーションの作成を参照してください。

Groups 権限を認可するには、管理者は組織全体に対してGroups のアクセス許可を付与する必要があります。これは、管理者の認可エンドポイントを介して実行できます。管理者に次のWeb ページに移動して許可を与えさせるだけです。その後、通常どおりにOAuth 認可を実行します。

https://login.microsoftonline.com/common/adminconsent?client_id=[YourClientId]&redirect_uri=http://localhost:33333

組織に複数のテナントがある場合は、url の/common/ をテナントのID に置き換えて、どのテナントに権限を付与するかを指定できます。

Select

すべてのグループを取得したり、GroupId (Id) を指定したり、あるいは特定のカラムでフィルタしたりします。

SELECT * FROM Groups WHERE Id = 'Group Id here'
SELECT Id, Description, DisplayName FROM Groups WHERE DisplayName = 'test'

Insert

新しいSecurity Group を作成するには、以下が必要です。

INSERT INTO Groups (DisplayName, MailEnabled, MailNickname, SecurityEnabled) VALUES ('Test group', false, 'test', true)

Columns


Name	Type	ReadOnly	References	Description
id [KEY]	String	True		The unique identifier for the group.
Etag	String	False
deletedDateTime	Datetime	False
allowExternalSenders	Bool	False		Indicates if people external to the organization can send messages to the group.
assignedLabels	String	False
assignedLicenses	String	False
autoSubscribeNewMembers	Bool	False		Indicates if new members added to the group will be auto-subscribed to receive email notifications.
classification	String	False
createdDateTime	Datetime	False
description	String	False		An optional description for the group.
displayName	String	False		The display name for the group.
expirationDateTime	Datetime	False
groupTypes	String	False		Specifies the type of group to create. Possible values are Unified to create an Office 365 group, or DynamicMembership for dynamic groups. For all other group types, like security-enabled groups and email-enabled security groups, do not set this property.
hasMembersWithLicenseErrors	Bool	False
hideFromAddressLists	Bool	False
hideFromOutlookClients	Bool	False
isArchived	Bool	False
isSubscribedByMail	Bool	False		Indicates whether the current user is subscribed to receive email conversations.
licenseProcessingState_state	String	False
mail	String	False		The SMTP address for the group.
mailEnabled	Bool	False		Specifies whether the group is mail-enabled. If the securityEnabled property is also true, the group is a mail-enabled security group; otherwise, the group is a Microsoft Exchange distribution group.
mailNickname	String	False		The mail alias for the group, unique in the organization.
membershipRule	String	False
membershipRuleProcessingState	String	False
onPremisesDomainName	String	False
onPremisesLastSyncDateTime	Datetime	False		Indicates the last time at which the group was synced with the on-premises directory.
onPremisesNetBiosName	String	False
onPremisesProvisioningErrors	String	False
onPremisesSamAccountName	String	False
onPremisesSecurityIdentifier	String	False		Contains the on-premises security identifier (SID) for the group that was synchronized from on-premises to the cloud.
onPremisesSyncEnabled	Bool	False		True if this group is synced from an on-premises directory; false if this group was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory.
preferredDataLocation	String	False
preferredLanguage	String	False
proxyAddresses	String	False		The proxy addresses for the table Groups.
renewedDateTime	Datetime	False
securityEnabled	Bool	False		Specifies whether the group is a security group. If the mailEnabled property is also true, the group is a mail-enabled security group; otherwise it is a security group. Must be false for Office 365 groups.
securityIdentifier	String	False
theme	String	False
unseenCount	Int	False		Count of posts that the current user has not seen since his last visit.
visibility	String	False		Specifies the visibility of an Office 365 group. The possible values are: Private, Public, HiddenMembership, or empty (which is interpreted as Public).

Messages

The Office365 table Messages.

テーブル固有の情報

Select

Messages からすべてを取得したり、Message (Id)、UserId、またはParentFolderId を指定したり、あるいは結果を特定のカラムでフィルタしたりできます。

SELECT * FROM Messages WHERE Id = 'MyMessageId'

SELECT * FROM Messages WHERE UserId = 'MyUserId'

SELECT * FROM Messages WHERE ParentFolderId = 'MyParentfolderId' 
SELECT * FROM Messages WHERE ParentFolderId = 'Drafts'
SELECT DisplayName, Id FROM Users WHERE DisplayName LIKE 'John%'

Insert

INSERT 後、新しいMessage がユーザーのDrafts フォルダに作成されます。

INSERT INTO Messages (Subject, Body_Content, UserId) VALUES ('New test Email', 'Test Email created.', 'User Id goes here')

Note：メールを送信するには、SendMail を参照してください。

Update

To update a message:

UPDATE Messages SET Subject = 'Email Updated', Body_Content = 'New Body Content' WHERE Id = 'MyMessageId'

Preserving HTML Formatting

If you are executing an INSERT or UPDATE and your message has HTML in its body_content, you must set body_contentType to 'html'.

UPDATE Messages SET body_content = '<my html document>', body_contentType = 'html'

If you don't set body_contentType to 'html', the HTML content of the message (such as elements and tags) will be visible in the body of the resulting email as plaintext instead of being processed as HTML.

Known Issues

This table may return an inconsistent number of results. That is, it can return a number of rows for one query and a different numbers of rows in subsequent queries, even when your messages remain unchanged. This means that some messages may be missing when querying this table.

This is a known bug in the Microsoft Graph API.

There is a workaround that allows the Sync App to retrieve all messages, but it comes with a tradeoff: 'events' and 'contacts' data will be returned along with 'messages' data. When using this workaround, you must use filtering to distinguish between message and non-message rows.

To enable this workaround, add "ClientSidePaging=true;" (without quotation marks) in the value of the Other connection property.

Columns


Name	Type	ReadOnly	References	Description
id [KEY]	String	True		The id column of the Messages table.
Etag	String	False		The Etag column of the Messages table.
categories	String	False		The categories column of the Messages table.
changeKey	String	False		The changeKey column of the Messages table.
createdDateTime	Datetime	False		The createdDateTime column of the Messages table.
lastModifiedDateTime	Datetime	False		The lastModifiedDateTime column of the Messages table.
bccRecipients	String	False		The bccRecipients column of the Messages table.
body_content	String	False		The body_content column of the Messages table.
body_contentType	String	False		The body_contentType column of the Messages table.
bodyPreview	String	False		The bodyPreview column of the Messages table.
ccRecipients	String	False		The ccRecipients column of the Messages table.
conversationId	String	False		The conversationId column of the Messages table.
conversationIndex	Binary	False		The conversationIndex column of the Messages table.
flag_completedDateTime_dateTime	Datetime	False		The flag_completedDateTime_dateTime column of the Messages table.
flag_completedDateTime_timeZone	String	False		The flag_completedDateTime_timeZone column of the Messages table.
flag_flagStatus	String	False		The flag_flagStatus column of the Messages table.
from_emailAddress_address	String	False		The from_emailAddress_address column of the Messages table.
from_emailAddress_name	String	False		The from_emailAddress_name column of the Messages table.
hasAttachments	Bool	False		The hasAttachments column of the Messages table.
importance	String	False		The importance column of the Messages table.
inferenceClassification	String	False		The inferenceClassification column of the Messages table.
internetMessageHeaders	String	False		The internetMessageHeaders column of the Messages table.
internetMessageId	String	False		The internetMessageId column of the Messages table.
isDeliveryReceiptRequested	Bool	False		The isDeliveryReceiptRequested column of the Messages table.
isDraft	Bool	False		The isDraft column of the Messages table.
isRead	Bool	False		The isRead column of the Messages table.
isReadReceiptRequested	Bool	False		The isReadReceiptRequested column of the Messages table.
parentFolderId	String	False		The parentFolderId column of the Messages table.
receivedDateTime	Datetime	False		The receivedDateTime column of the Messages table.
replyTo	String	False		The replyTo column of the Messages table.
sender_emailAddress_address	String	False		The sender_emailAddress_address column of the Messages table.
sender_emailAddress_name	String	False		The sender_emailAddress_name column of the Messages table.
sentDateTime	Datetime	False		The sentDateTime column of the Messages table.
subject	String	False		The subject column of the Messages table.
toRecipients	String	False		The toRecipients column of the Messages table.
uniqueBody_content	String	False		The uniqueBody_content column of the Messages table.
uniqueBody_contentType	String	False		The uniqueBody_contentType column of the Messages table.
webLink	String	False		The webLink column of the Messages table.
UserId	String	False		The UserId column of the Messages table.
IsEventMessage	Bool	False		he column to distinguish if the messages is with calendar/event invites

Tasks

The Office365 table Tasks.

Table Specific Information

Tasks requires the Groups and Tasks permissions from the Microsoft Graph. For this reason, you must create your own OAuth App. Please see Azure AD アプリケーションの作成 for more details.

Select

By default, if no criteria is specified, only Tasks personally assigned to you will show up. For example:

SELECT * FROM Tasks

To bring back tasks across the organization, provide the specific plans ids, or use a subselect for the plan id. For example:

SELECT * FROM Tasks WHERE PlanId IN (SELECT Id FROM Plans)

Insert

To insert a Task, the associated plan must be specified:

INSERT INTO Tasks (Title, PlanId) VALUES ('My Title', '99999999-eeeeeeeee')

Update

To update a Task, both the Id and Etag must be specified:

UPDATE Tasks SET Title = 'New Title' WHERE Id = 'xxxxxx-AAAAAAAAAAA' AND Etag = 'W/\"XXXXXXQEBAQEBAQEBAQEBAQEBARCc=\"'

Delete

To delete a Task, both the Id and Etag must be specified:

DELETE FROM Tasks WHERE Id = 'xxxxxx-AAAAAAAAAAA' AND Etag = 'W/\"XXXXXXQEBAQEBAQEBAQEBAQEBARCc=\"'

Columns


Name	Type	ReadOnly	References	Description
activeChecklistItemCount	Int	False
appliedCategories	String	False
assigneePriority	String	False
assignments	String	False
bucketId	String	False
checklistItemCount	Int	False
completedBy_application_displayName	String	False
completedBy_application_id	String	False
completedDateTime	Datetime	False
conversationThreadId	String	False
createdBy_application_displayName	String	False
createdBy_application_id	String	False
createdDateTime	Datetime	False
dueDateTime	Datetime	False
hasDescription	Bool	False
orderHint	String	False
percentComplete	Int	False
planId	String	False
previewType	String	False
priority	Int	False
referenceCount	Int	False
startDateTime	Datetime	False
title	String	False
Etag	String	False
Id [KEY]	String	False

Users

Read, Insert, Update and Delete a User.

テーブル固有の情報

Select

Users からすべてを取得したり、Id を指定したり、カラムでフィルタリングしたりすることで、Users テーブルをクエリします。

SELECT * FROM Users WHERE Id = '616391f0-32d8-4127-8f25-aa55771d6617'

SELECT DisplayName, Id FROM Users WHERE DisplayName LIKE 'John%'

Insert

新しい組織User を作成するには、以下が必要です。

INSERT INTO Users (AccountEnabled, DisplayName, MailNickname, UserPrincipalName, PasswordProfile_ForceChangePasswordNextSignIn, PasswordProfile_Password) VALUES (false, 'John Smith', 'JohnS', '[email protected]', true, '123password')

Columns


Name	Type	ReadOnly	References	Description
id [KEY]	String	True
deletedDateTime	Datetime	False
accountEnabled	Bool	False
businessPhones	String	False
city	String	False
companyName	String	False
country	String	False
createdDateTime	Datetime	False
department	String	False
displayName	String	False
employeeHireDate	Datetime	False
employeeId	String	False
employeeLeaveDateTime	Datetime	False
employeeOrgData_costCenter	String	False
employeeOrgData_division	String	False
employeeType	String	False
givenName	String	False
identities	String	False
imAddresses	String	False
isResourceAccount	Bool	False
jobTitle	String	False
lastPasswordChangeDateTime	Datetime	False
mail	String	False
mailNickname	String	False
mobilePhone	String	False
officeLocation	String	False
onPremisesDistinguishedName	String	False
onPremisesDomainName	String	False
onPremisesExtensionAttributes_extensionAttribute1	String	False
onPremisesExtensionAttributes_extensionAttribute10	String	False
onPremisesExtensionAttributes_extensionAttribute11	String	False
onPremisesExtensionAttributes_extensionAttribute12	String	False
onPremisesExtensionAttributes_extensionAttribute13	String	False
onPremisesExtensionAttributes_extensionAttribute14	String	False
onPremisesExtensionAttributes_extensionAttribute15	String	False
onPremisesExtensionAttributes_extensionAttribute2	String	False
onPremisesExtensionAttributes_extensionAttribute3	String	False
onPremisesExtensionAttributes_extensionAttribute4	String	False
onPremisesExtensionAttributes_extensionAttribute5	String	False
onPremisesExtensionAttributes_extensionAttribute6	String	False
onPremisesExtensionAttributes_extensionAttribute7	String	False
onPremisesExtensionAttributes_extensionAttribute8	String	False
onPremisesExtensionAttributes_extensionAttribute9	String	False
onPremisesImmutableId	String	False
onPremisesLastSyncDateTime	Datetime	False
onPremisesProvisioningErrors	String	False
onPremisesSamAccountName	String	False
onPremisesSecurityIdentifier	String	False
onPremisesSyncEnabled	Bool	False
onPremisesUserPrincipalName	String	False
otherMails	String	False
passwordProfile_forceChangePasswordNextSignIn	Bool	False
passwordProfile_forceChangePasswordNextSignInWithMfa	Bool	False
passwordProfile_password	String	False
postalCode	String	False
preferredLanguage	String	False
securityIdentifier	String	False
state	String	False
streetAddress	String	False
surname	String	False
userPrincipalName	String	False
userType	String	False

ビュー

ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。

クエリは、ビューに対して通常のテーブルと同様に実行することができます。

Microsoft Office 365 Connector for CData Sync ビュー


Name	Description
CalendarView	Retrieve the ccurrences, exceptions, and single instances of events in a calendar view defined by a time range, from the user's default calendar, or from some other calendar of the user's.
EventAttachments	EventAttachments View for Office365 data provider.
EventOccurrences	Usage information for the operation EventOccurrences.rsd.
MessageAttachments	MessageAttachments View for Office365 data provider.
Plans	The Office365 table Plans.

CalendarView

Retrieve the ccurrences, exceptions, and single instances of events in a calendar view defined by a time range, from the user's default calendar, or from some other calendar of the user's.

Table Specific Information

Select

Get the occurrences, exceptions, and single instances of events in a calendar view defined by a time range, from the user's default calendar, or from some other calendar of the user's. By default only the event occurrences from the user's default calendar in the range of the last 30 days will be returned. You can filter results by CalendarId, UserId, Start_DateTime, End_DateTime.

For example the following queries will be processed server side:

SELECT * FROM CalendarView WHERE Start_DateTime >= '2019-12-10 15:00' AND End_DateTime <= '2020-01-10 14:30'

SELECT * FROM CalendarView WHERE CalendarId = 'AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD-FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAwcAAABDJHYjDdygQ5pQPUEu3S2cAAACC_IAAAA='

SELECT * FROM CalendarView WHERE CalendarId = 'AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD-FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAwcAAABDJHYjDdygQ5pQPUEu3S2cAAACC_IAAAA=' AND UserId = 'a98f25b5-5da1-4937-8729-c0d03026caa0' AND Start_DateTime >= '2019-12-15 08:00' AND End_DateTime <= '2020-01-14 08:00'

Columns

References Description String String String String Datetime Datetime Bool String String String String Datetime String Bool Bool String String Bool Bool Bool Bool Bool Bool String String String String String Double Double Double Double Double String String String String String String String String String String String String String String String String String String Datetime String Int String String String Int Int String Datetime Int String Datetime String Int Bool String Datetime String String String Datetime String String String String String String String />


Name	Type style="white-space:nowrap">id
Etag
categories
changeKey
createdDateTime
lastModifiedDateTime
allowNewTimeProposals
attendees
body_content
body_contentType
bodyPreview
end_dateTime
end_timeZone
hasAttachments
hideAttendees
iCalUId
importance
isAllDay
isCancelled
isDraft
isOnlineMeeting
isOrganizer
isReminderOn
location_address_city
location_address_countryOrRegion
location_address_postalCode
location_address_state
location_address_street
location_coordinates_accuracy
location_coordinates_altitude
location_coordinates_altitudeAccuracy
location_coordinates_latitude
location_coordinates_longitude
location_displayName
location_locationEmailAddress
location_locationType
location_locationUri
location_uniqueId
location_uniqueIdType
locations
onlineMeeting_conferenceId
onlineMeeting_joinUrl
onlineMeeting_phones
onlineMeeting_quickDial
onlineMeeting_tollFreeNumbers
onlineMeeting_tollNumber
onlineMeetingProvider
onlineMeetingUrl
organizer_emailAddress_address
organizer_emailAddress_name
originalEndTimeZone
originalStart
originalStartTimeZone
recurrence_pattern_dayOfMonth
recurrence_pattern_daysOfWeek
recurrence_pattern_firstDayOfWeek
recurrence_pattern_index
recurrence_pattern_interval
recurrence_pattern_month
recurrence_pattern_type
recurrence_range_endDate
recurrence_range_numberOfOccurrences
recurrence_range_recurrenceTimeZone
recurrence_range_startDate
recurrence_range_type
reminderMinutesBeforeStart
responseRequested
responseStatus_response
responseStatus_time
sensitivity
seriesMasterId
showAs
start_dateTime
start_timeZone
subject
transactionId
type
webLink
UserId
CalendarId

EventAttachments

EventAttachments View for Office365 data provider.

Columns


Name	Type	References	Description
eventId	String	Events.Id
id [KEY]	String
contentType	String
isInline	Bool
lastModifiedDateTime	Datetime
name	String
size	Int

EventOccurrences

Usage information for the operation EventOccurrences.rsd.

Table Specific Information

Select

You can query EventOccurrences by specifying the Event Id, StartDatetime and EndDateTime. EventId is a required field, instead StartDatetime and EndDateTime have a default range of the last 30 days. If you query filtering only by EventId and the specific event does not exist within this time range, you will get empty results.

SELECT * FROM [EventOccurrences] WHERE id = 'event id' AND StartDateTime = '2018/01/01' AND EndDateTime = '2018/12/31'

By default, if StartDateTime and EndDateTime filters are not specified, only the event occurrences from the user's default calendar in the range of the last 30 days will be returned. Otherwise, the query will get the Occurrences of the Event during the period specified by StartDateTime and EndDateTime.

Columns


Name	Type	References	Description
GroupId	String
UserId	String
Events_id [KEY]	String	Events.id
id [KEY]	String
categories	String
changeKey	String
createdDateTime	Datetime
lastModifiedDateTime	Datetime
allowNewTimeProposals	Bool
attendees	String
body_content	String
body_contentType	String
bodyPreview	String
end_dateTime	Datetime
end_timeZone	String
hasAttachments	Bool
hideAttendees	Bool
iCalUId	String
importance	String
isAllDay	Bool
isCancelled	Bool
isDraft	Bool
isOnlineMeeting	Bool
isOrganizer	Bool
isReminderOn	Bool
location_address_city	String
location_address_countryOrRegion	String
location_address_postalCode	String
location_address_state	String
location_address_street	String
location_coordinates_accuracy	Double
location_coordinates_altitude	Double
location_coordinates_altitudeAccuracy	Double
location_coordinates_latitude	Double
location_coordinates_longitude	Double
location_displayName	String
location_locationEmailAddress	String
location_locationType	String
location_locationUri	String
location_uniqueId	String
location_uniqueIdType	String
locations	String
onlineMeeting_conferenceId	String
onlineMeeting_joinUrl	String
onlineMeeting_phones	String
onlineMeeting_quickDial	String
onlineMeeting_tollFreeNumbers	String
onlineMeeting_tollNumber	String
onlineMeetingProvider	String
onlineMeetingUrl	String
organizer_emailAddress_address	String
organizer_emailAddress_name	String
originalEndTimeZone	String
originalStart	Datetime
originalStartTimeZone	String
recurrence_pattern_dayOfMonth	Int
recurrence_pattern_daysOfWeek	String
recurrence_pattern_firstDayOfWeek	String
recurrence_pattern_index	String
recurrence_pattern_interval	Int
recurrence_pattern_month	Int
recurrence_pattern_type	String
recurrence_range_endDate	Datetime
recurrence_range_numberOfOccurrences	Int
recurrence_range_recurrenceTimeZone	String
recurrence_range_startDate	Datetime
recurrence_range_type	String
reminderMinutesBeforeStart	Int
responseRequested	Bool
responseStatus_response	String
responseStatus_time	Datetime
sensitivity	String
seriesMasterId	String
showAs	String
start_dateTime	Datetime
start_timeZone	String
subject	String
transactionId	String
type	String
webLink	String

MessageAttachments

MessageAttachments View for Office365 data provider.

Columns


Name	Type	References	Description
messageId	String	Messages.Id
id [KEY]	String
contentType	String
isInline	Bool
lastModifiedDateTime	Datetime
name	String
size	Int

Plans

The Office365 table Plans.

Table Specific Information

Using Plans requires access to Groups permissions. This requires Admin approval. For this reason, you must use your own OAuth App to add the Groups permissions and from the Microsoft Graph. See Azure AD アプリケーションの作成 for more details.

Select

All plans in MS Planner exist as a part of a group. In order to retrieve the list of available plans, you must retrieve a list of available plans per group. If no GroupId is specified, then the following WHERE condition will be appended to any query:

GroupId IN (SELECT Id FROM Groups)

Columns


Name	Type	References	Description
container_containerId	String
container_type	String
container_url	String
createdBy_application_displayName	String
createdBy_application_id	String
createdDateTime	Datetime
owner	String
title	String
GroupId	String
Id [KEY]	String

データ型マッピング

データ型のマッピング

Sync App は、データソースの型を、スキーマで使用可能な対応するデータ型にマッピングします。以下のテーブルはこれらのマッピングを説明します。


Microsoft Office 365 (OData V4)	CData スキーマ
Edm.Binary	binary
Edm.Boolean	bool
Edm.Date	datetime
Edm.DateTimeOffset	datetime
Edm.Decimal	decimal
Edm.Double	double
Edm.Guid	guid
Edm.Int32	int
Edm.String	string
Edm.TimeOfDay	time

接続文字列オプション

接続文字列プロパティは、接続を確立するために使用できるさまざまなオプションです。このセクションでは、本プロバイダーの接続文字列で設定できるオプションの一覧を示します。詳細については各リンクをクリックしてください。

接続を確立する方法について詳しくは、接続の確立を参照してください。

Authentication

プロパティ	説明
AuthScheme	Microsoft Office 365 に接続する際に使用する認証の種類を指定します。このプロパティが空白の場合は、デフォルトの認証が使用されます。

Azure Authentication

プロパティ	説明
AzureTenant	データにアクセスするために使用されるMicrosoft Office 365 テナントを、名前（例えば、contoso.omnicrosoft.com）またはID で識別します。（条件付き）
AzureEnvironment	接続するAzure ネットワーク環境を指定します。Azure アカウントが追加されたネットワークと同じである必要があります。

OAuth

プロパティ	説明
OAuthVersion	使われているOAuth のバージョン。
OAuthClientId	カスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。（コンシューマーキーとも呼ばれます。）このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。
OAuthClientSecret	カスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。（コンシューマーシークレットとも呼ばれます。）このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。
OAuthGrantType	選択したOAuth フローのグラント種別を指定します。この値は、OAuth カスタムアプリケーション作成時に設定されたグラント種別と同じである必要があります。

JWT OAuth

プロパティ	説明
OAuthJWTCert	JWT 証明書のストア。
OAuthJWTCertType	JWT 証明書を格納するキーストアの種類。
OAuthJWTCertPassword	OAuth JWT 証明書のパスワード。パスワードを必要とする証明書ストアにアクセスするために使用されます。証明書ストアがパスワードを必要としない場合は、このプロパティを空白のままにします。
OAuthJWTCertSubject	OAuth JWT 証明書のサブジェクトで、ストアで一致する証明書を検索するために使用されます。部分一致と、先頭の証明書を選択するためのワイルドカード '*' をサポートします。

SSL

プロパティ	説明
SSLServerCert	TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。

Firewall

プロパティ	説明
FirewallType	provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。
FirewallServer	ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。
FirewallPort	プロキシベースのファイアウォールで使用するTCP ポートを指定します。
FirewallUser	プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。
FirewallPassword	プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。

Proxy

プロパティ	説明
ProxyAutoDetect	provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。
ProxyServer	HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
ProxyPort	クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー（ProxyServer 接続プロパティで設定）のTCP ポート。
ProxyAuthScheme	ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。
ProxyUser	ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。
ProxyPassword	ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。
ProxySSLType	ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。
ProxyExceptions	ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

Logging

プロパティ	説明
LogModules	ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。

Schema

プロパティ	説明
Location	テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。
BrowsableSchemas	レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tables	レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。
Views	レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。

Miscellaneous

プロパティ	説明
DirectoryRetrievalDepth	Specify how many folders deep you want to get results for Files table. The resources directly in the root are located at depth 0. The resources one folder deeper are located at depth 1 and so on. You can specify the value -1 to get all the data in a drive no matter the depth they're in.
MaxRows	集計やGROUP BY を使用しないクエリで返される最大行数を指定します。
Other	特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。
Pagesize	Microsoft Office 365 から返される、1ページあたりの結果の最大数を指定します。この設定は、ほとんどのユースケースに最適化されている、データソースによって設定されたデフォルトのページサイズをオーバーライドします。
PseudoColumns	テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。
Timeout	provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。
UseClientSidePaging	Whether or not the CData ADO.NET Provider for Microsoft Office 365 should use client side paging.
UserDefinedViews	カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。

Authentication

このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。

プロパティ	説明
AuthScheme	Microsoft Office 365 に接続する際に使用する認証の種類を指定します。このプロパティが空白の場合は、デフォルトの認証が使用されます。

AuthScheme

Microsoft Office 365 に接続する際に使用する認証の種類を指定します。このプロパティが空白の場合は、デフォルトの認証が使用されます。

解説

AzureAD：Azure Active Directory（ユーザーベース）のOAuth 認証を実行します。
AzureMSI：Azure VM で実行している際に、Azure AD マネージドサービスID の資格情報を自動的に取得します。
AzureServicePrincipal：クライアントシークレットを使用してAzure サービスプリンシパル（ロールベース、アプリケーションベース）として認証します。
AzureServicePrincipalCert：証明書を使用してAzure サービスプリンシパル（ロールベース、アプリケーションベース）として認証します。

Azure AD で認証するためのカスタムアプリケーションの作成方法については、Azure AD アプリケーションの作成を参照してください。

Azure AD サービスプリンシパルで認証するためのカスタムアプリケーションの作成方法については、サービスプリンシパルによるAzure AD アプリの作成を参照してください。

Azure Authentication

このセクションでは、本プロバイダーの接続文字列で設定可能なAzure Authentication プロパティの全リストを提供します。

プロパティ	説明
AzureTenant	データにアクセスするために使用されるMicrosoft Office 365 テナントを、名前（例えば、contoso.omnicrosoft.com）またはID で識別します。（条件付き）
AzureEnvironment	接続するAzure ネットワーク環境を指定します。Azure アカウントが追加されたネットワークと同じである必要があります。

AzureTenant

データにアクセスするために使用されるMicrosoft Office 365 テナントを、名前（例えば、contoso.omnicrosoft.com）またはID で識別します。（条件付き）

解説

テナントは、主にドメイン（例えば、microsoft.com）に関連付けられた、組織のデジタル表現です。テナントは、Tenant ID（ディレクトリID とも呼ばれる）によって管理されます。これは、Azure リソースへのアクセスや管理権限をユーザーに割り当てる際に指定します。

Azure ポータルでディレクトリID を見つけるには、Azure Active Directory -> プロパティに移動します。

AuthScheme = AzureServicePrincipal またはAzureServicePrincipalCert のいずれかである場合、またはAzureTenant = AzureAD であり、ユーザーが複数のテナントに属している場合は、AzureTenant を指定する必要があります。

AzureEnvironment

接続するAzure ネットワーク環境を指定します。Azure アカウントが追加されたネットワークと同じである必要があります。

解説

Azure アカウントがGlobal ネットワークとは異なるネットワーク（China、USGOVT、USGOVTDOD など）の一部である場合は、必要です。

OAuth

このセクションでは、本プロバイダーの接続文字列で設定可能なOAuth プロパティの全リストを提供します。

プロパティ	説明
OAuthVersion	使われているOAuth のバージョン。
OAuthClientId	カスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。（コンシューマーキーとも呼ばれます。）このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。
OAuthClientSecret	カスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。（コンシューマーシークレットとも呼ばれます。）このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。
OAuthGrantType	選択したOAuth フローのグラント種別を指定します。この値は、OAuth カスタムアプリケーション作成時に設定されたグラント種別と同じである必要があります。

OAuthVersion

使われているOAuth のバージョン。

解説

使われているOAuth のバージョン。次のオプションが利用可能です：1.0,2.0

OAuthClientId

カスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。（コンシューマーキーとも呼ばれます。）このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。

解説

OAuthClientId は、ユーザーがOAuth 経由で認証を行う前に設定する必要があるいくつかの接続パラメータの1つです。詳細は接続の確立を参照してください。

OAuthClientSecret

カスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。（コンシューマーシークレットとも呼ばれます。）このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。

解説

OAuthClientSecret は、ユーザーがOAuth 経由で認証を行う前に設定する必要があるいくつかの接続パラメータの1つです。詳細は接続の確立を参照してください。

OAuthGrantType

選択したOAuth フローのグラント種別を指定します。この値は、OAuth カスタムアプリケーション作成時に設定されたグラント種別と同じである必要があります。

解説

ほとんどの場合、デフォルトのグラント種別は変更すべきではありません。最も一般的なOAuth グラント種別とそれぞれのメリット・デメリットについては、https://oauth.net/2/grant-types/ を参照してください。

JWT OAuth

このセクションでは、本プロバイダーの接続文字列で設定可能なJWT OAuth プロパティの全リストを提供します。

プロパティ	説明
OAuthJWTCert	JWT 証明書のストア。
OAuthJWTCertType	JWT 証明書を格納するキーストアの種類。
OAuthJWTCertPassword	OAuth JWT 証明書のパスワード。パスワードを必要とする証明書ストアにアクセスするために使用されます。証明書ストアがパスワードを必要としない場合は、このプロパティを空白のままにします。
OAuthJWTCertSubject	OAuth JWT 証明書のサブジェクトで、ストアで一致する証明書を検索するために使用されます。部分一致と、先頭の証明書を選択するためのワイルドカード '*' をサポートします。

OAuthJWTCert

JWT 証明書のストア。

解説

クライアント証明書のための証明書ストア名。

OAuthJWTCertType フィールドは、OAuthJWTCert により指定された証明書ストアの種類を指定します。ストアがパスワードで保護されている場合は、OAuthJWTCertPassword でパスワードを指定します。

OAuthJWTCert は、OAuthJWTCertSubject フィールドとともにクライアント証明書を指定するために使われます。 OAuthJWTCert に値がある場合で、OAuthJWTCertSubject が設定されている場合は、証明書の検索が始まります。詳しくは、OAuthJWTCertSubject フィールドを参照してください。

証明書ストアの指定はプラットフォームに依存します。

Windows の共通のユーザとシステム証明書ストアの指定は以下のとおりです。


MY	個人証明書と関連付けられた秘密キーを格納している証明書ストア。
CA	証明機関の証明書。
ROOT	ルート証明書。
SPC	ソフトウェア発行元証明書。

Javaでは、証明書ストアは通常、証明書および任意の秘密キーを含むファイルです。

証明書ストアの種類がPFXFile の場合は、このプロパティにファイル名を設定します。 PFXBlob の場合は、このプロパティをPFX ファイルのバイナリコンテンツ（例えば、PKCS12証明書ストア）に設定する必要があります。

OAuthJWTCertType

JWT 証明書を格納するキーストアの種類。

解説

このプロパティには次の値の一つを設定できます。


USER	Windows の場合、現在のユーザーにより所有された証明書ストアであることを指定します。 Note：この種類はJava では利用できません。
MACHINE	Windows の場合、この証明書ストアがシステムストアであることを指定します。 Note：この種類はJava では利用できません。
PFXFILE	この証明書ストアは、証明書を含むPFX（PKCS12）ファイルの名前です。
PFXBLOB	この証明書ストアは、PFX（PKCS12）形式の証明書ストアを表すBase-64でエンコードされた文字列です。
JKSFILE	この証明書ストアは、証明書を含むJava key store（JKS）ファイルの名前です。 Note：この種類はJava のみで利用できます。
JKSBLOB	この証明書ストアは、Java key store（JKS）形式の証明書ストアを表すBase-64でエンコードされた文字列です。 Note：この種類はJava のみで利用できます。
PEMKEY_FILE	この証明書ストアは、秘密キーと任意の証明書を含むPEM でエンコードされたファイルの名前です。
PEMKEY_BLOB	この証明書ストアは、秘密キーと任意の証明書を含むBase-64でエンコードされた文字列です。
PUBLIC_KEY_FILE	この証明書ストアは、PEM またはDER でエンコードされた公開キーの証明書を含むファイルの名前です。
PUBLIC_KEY_BLOB	この証明書ストアは、PEM またはDER でエンコードされた公開キーの証明書を含むBase-64でエンコードされた文字列です。
SSHPUBLIC_KEY_FILE	この証明書ストアは、SSH 公開キーを含むファイルの名前です。
SSHPUBLIC_KEY_BLOB	この証明書ストアは、SSH 公開キーを含むBase-64でエンコードされた文字列です。
P7BFILE	この証明書ストアは、証明書を含むPKCS7 ファイルの名前です。
PPKFILE	この証明書ストアは、PuTTY 秘密キー（PPK）を含むファイルの名前です。
XMLFILE	この証明書ストアは、XML 形式の証明書を含むファイルの名前です。
XMLBLOB	この証明書ストアは、XML 形式の証明書を含む文字列の名前です。
BCFKSFILE	この証明書ストアは、Bouncy Castle キーストアを含むファイルの名前です。
BCFKSBLOB	この証明書ストアは、Bouncy Castle キーストアを含む文字列（Base-64エンコード）です。

OAuthJWTCertPassword

OAuth JWT 証明書のパスワード。パスワードを必要とする証明書ストアにアクセスするために使用されます。証明書ストアがパスワードを必要としない場合は、このプロパティを空白のままにします。

解説

このプロパティは、証明書ストアを開くために必要なパスワードを指定します。ただし、ストアの種類がパスワードを必要とする場合に限ります。パスワードが必要かどうかを判断するには、ご利用の証明書ストアのドキュメントまたは設定を参照してください。

OAuthJWTCertSubject

OAuth JWT 証明書のサブジェクトで、ストアで一致する証明書を検索するために使用されます。部分一致と、先頭の証明書を選択するためのワイルドカード '*' をサポートします。

解説

このプロパティの値は、ストアで一致する証明書を検索するために使用されます。検索プロセスは以下のように動作します。

サブジェクトに完全に一致する証明書が見つかれば、該当する証明書が選択されます。
完全に一致するものがない場合、ストアは、サブジェクトがプロパティ値を含む証明書を検索します。
一致する証明書がない場合、証明書は選択されません。

値を '*' に設定すると、ストアの先頭の証明書が自動的に選択されます。証明書のサブジェクトは識別名フィールドおよび値のカンマ区切りのリストです。例：CN=www.server.com, OU=test, C=US, [email protected]。一般的なフィールドには以下のものが含まれます。


フィールド	説明
CN	共通名。一般的には、www.server.com のようなホスト名です。
O	法人名
OU	法人の部署名
L	法人の住所（市町村名）
S	法人の住所（都道府県）
C	国名
E	E メールアドレス

フィールド値にカンマが含まれる場合は、引用符で囲んでください。例："O=ACME, Inc."。

SSL

このセクションでは、本プロバイダーの接続文字列で設定可能なSSL プロパティの全リストを提供します。

プロパティ	説明
SSLServerCert	TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。

SSLServerCert

TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。

解説

TLS/SSL 接続を使用する場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。コンピュータによって信頼されていない他の証明書はすべて拒否されます。

このプロパティは、次のフォームを取ります：


説明	例
フルPEM 証明書（例では省略されています）	-----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE-----
証明書を保有するローカルファイルへのパス。	C:\cert.cer
公開鍵（例では省略されています）	-----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY-----
MD5 Thumbprint （hex 値はスペースおよびコロン区切り）	ecadbdda5a1529c58a1e9e09828d70e4
SHA1 Thumbprint （hex 値はスペースおよびコロン区切り）	34a929226ae0819f2ec14b4a3d904f801cbb150d

これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。

すべての証明書の受け入れを示すには、'*'を使用します。セキュリティ上の理由から、これはお勧めできません。

Firewall

このセクションでは、本プロバイダーの接続文字列で設定可能なFirewall プロパティの全リストを提供します。

プロパティ	説明
FirewallType	provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。
FirewallServer	ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。
FirewallPort	プロキシベースのファイアウォールで使用するTCP ポートを指定します。
FirewallUser	プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。
FirewallPassword	プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。

FirewallType

provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

Note：デフォルトでは、Sync App はシステムプロキシに接続します。この動作を無効化し、次のプロキシタイプのいずれかに接続するには、ProxyAutoDetect をfalse に設定します。

次の表は、サポートされている各プロトコルのポート番号情報です。


プロトコル	デフォルトポート	説明
TUNNEL	80	Sync App がMicrosoft Office 365 への接続を開くポート。トラフィックはこの場所のプロキシを経由して行き来します。
SOCKS4	1080	Sync App がMicrosoft Office 365 への接続を開くポート。SOCKS 4 は次にFirewallUser 値をプロキシに渡し、接続リクエストが許容されるかどうかを決定します。
SOCKS5	1080	Sync App がMicrosoft Office 365 にデータを送信するポート。SOCKS 5 プロキシに認証が必要な場合には、FirewallUser およびFirewallPassword をプロキシが認識する認証情報に設定します。

HTTP プロキシへの接続には、ProxyServer およびProxyPort ポートを使ってください。HTTP プロキシへの認証には、ProxyAuthScheme、ProxyUser、およびProxyPassword を使ってください。

FirewallServer

ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

FirewallPort

プロキシベースのファイアウォールで使用するTCP ポートを指定します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

FirewallUser

プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

FirewallPassword

プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

Proxy

このセクションでは、本プロバイダーの接続文字列で設定可能なProxy プロパティの全リストを提供します。

プロパティ	説明
ProxyAutoDetect	provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。
ProxyServer	HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
ProxyPort	クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー（ProxyServer 接続プロパティで設定）のTCP ポート。
ProxyAuthScheme	ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。
ProxyUser	ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。
ProxyPassword	ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。
ProxySSLType	ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。
ProxyExceptions	ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

ProxyAutoDetect

provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。

解説

この接続プロパティをTrue に設定すると、Sync App は既存のプロキシサーバー構成についてシステムプロキシ設定をチェックします（プロキシサーバーの詳細を手動で入力する必要はありません）。

この接続プロパティは他のプロキシ設定より優先されます。特定のプロキシサーバーに接続するためにSync App を手動で構成する場合は、False に設定します。

HTTP プロキシへの接続には、ProxyServer を参照してください。SOCKS やトンネリングなどの他のプロキシには、FirewallType を参照してください。

ProxyServer

HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。

解説

ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたプロキシサーバーを通じてのみHTTP トラフィックをルーティングします。ProxyAutoDetect がTrue に設定されている場合（デフォルト）、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーを介してHTTP トラフィックをルーティングします。

ProxyPort

クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー（ProxyServer 接続プロパティで設定）のTCP ポート。

解説

ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたプロキシサーバーポートを通じてのみHTTP トラフィックをルーティングします。ProxyAutoDetect がTrue に設定されている場合（デフォルト）、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーポートを介してHTTP トラフィックをルーティングします。

その他のプロキシタイプについては、FirewallType を参照してください。

ProxyAuthScheme

ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。

解説

認証タイプは次のいずれかです。

BASIC：Sync App はHTTP BASIC 認証を行います。
DIGEST：Sync App はHTTP DIGEST 認証を行います。
NTLM：Sync App はNTLM トークンを取得します。
NEGOTIATE：Sync App は認証において有効なプロトコルに応じて、NTLM もしくはKerberos トークンを取得します。
NONE：ProxyServer が認証を必要としない場合に設定します。

"NONE" 以外のすべての値については、ProxyUser およびProxyPassword 接続プロパティも設定する必要があります。

SOCKS 5 認証のような他の認証タイプを使用するには、FirewallType を参照してください。

ProxyUser

ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。

解説

ProxyUser および ProxyPassword 接続プロパティは、ProxyServer で指定されたHTTP プロキシに対して接続よび認証するために使用されます。

ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。


ProxyAuthScheme の値	ProxyUser に設定する値
BASIC	プロキシサーバーに登録されているユーザーのユーザー名。
DIGEST	プロキシサーバーに登録されているユーザーのユーザー名。
NEGOTIATE	プロキシサーバーが属するドメインまたは信頼されたドメイン内の有効なユーザーであるWindows ユーザーのユーザー名。`user@domain` または`domain\user` の形式で指定。
NTLM	プロキシサーバーが属するドメインまたは信頼されたドメイン内の有効なユーザーであるWindows ユーザーのユーザー名。`user@domain` または`domain\user` の形式で指定。
NONE	ProxyPassword 接続プロパティは設定しないでください。

Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このユーザー名を使用します。ProxyAutoDetect がTrue に設定されている場合（デフォルト）、Sync App は代わりにシステムのプロキシ設定で指定されているユーザー名を使用します。

ProxyPassword

ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。

解説

ProxyUser および ProxyPassword 接続プロパティは、ProxyServer で指定されたHTTP プロキシに対して接続よび認証するために使用されます。

ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。


ProxyAuthScheme の値	ProxyPassword に設定する値
BASIC	ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。
DIGEST	ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。
NEGOTIATE	ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。
NTLM	ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。
NONE	ProxyPassword 接続プロパティは設定しないでください。

SOCKS 5 認証もしくは、トンネリングは、FirewallType を参照してください。

Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このパスワードを使用します。ProxyAutoDetect がTrue に設定されている場合（デフォルト）、Sync App は代わりにシステムのプロキシ設定で指定されているパスワードを使用します。

ProxySSLType

ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。

解説

このプロパティは、ProxyServer で指定されたHTTP プロキシへの接続にSSL を使用するかどうかを決定します。この接続プロパティには、以下の値を設定できます。


AUTO	デフォルト設定。ProxyServer がHTTPS URL に設定されている場合、Sync App は、TUNNEL オプションを使用します。ProxyServer がHTTP URL に設定されている場合、コンポーネントはNEVER オプションを使用します。
ALWAYS	接続は、常にSSL 有効となります。
NEVER	接続は、SSL 有効になりません。
TUNNEL	接続はトンネリングプロキシ経由で行われます。プロキシサーバーがリモートホストへの接続を開き、プロキシを経由して通信が行われます。

ProxyExceptions

ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

解説

ProxyServer は、このプロパティで定義されたアドレスを除くすべてのアドレスに使用されます。セミコロンを使用してエントリを区切ります。

Sync App はデフォルトでシステムプロキシ設定を使用するため、それ以上の設定は必要ありません。この接続にプロキシ例外を明示的に設定する場合は、ProxyAutoDetect をFalse に設定します。

Logging

このセクションでは、本プロバイダーの接続文字列で設定可能なLogging プロパティの全リストを提供します。

プロパティ	説明
LogModules	ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。

LogModules

ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。

解説

このプロパティは、含めるログモジュールを指定することでログファイルの内容をカスタマイズすることができます。ログモジュールは、クエリ実行、メタデータ、SSL 通信などの異なる領域にログ情報を分類します。各モジュールは4文字のコードで表され、文字の名前の場合は末尾にスペースが必要なものもあります。

例えば、EXEC はクエリ実行をログに記録し、INFO は一般的なプロバイダーメッセージをログに記録します。複数のモジュールを含めるには、次のように名前をセミコロンで区切ります：INFO;EXEC;SSL。

Verbosity 接続プロパティは、このプロパティで指定されたモジュールベースのフィルタリングよりも優先されます。 Verbosity レベルを満たし、指定されたモジュールに属するログエントリのみが記録されます。利用可能なすべてのモジュールをログファイルに含めるには、このプロパティを空白のままにします。

利用可能なモジュールの完全なリストとログの設定に関する詳細な手引きについては、ログの「高度なログの記録」セクションを参照してください。

Schema

このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。

プロパティ	説明
Location	テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。
BrowsableSchemas	レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tables	レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。
Views	レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。

Location

テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。

解説

Location プロパティは、定義をカスタマイズしたり（例えば、カラム名を変更する、カラムを無視するなど）、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。

指定しない場合、デフォルトの場所は%APPDATA%\\CData\\Office365 Data Provider\\Schema となり、%APPDATA%はユーザーのコンフィギュレーションディレクトリに設定されます：


プラットフォーム	%APPDATA%
Windows	APPDATA 環境変数の値
Linux	~/.config

BrowsableSchemas

レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。

解説

利用可能なデータベーススキーマをすべてリストすると余分な時間がかかり、パフォーマンスが低下します。接続文字列にスキーマのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

Tables

レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。

解説

データベースによっては、利用可能なすべてのテーブルをリストするのに時間がかかり、パフォーマンスが低下する場合があります。接続文字列にテーブルのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

利用可能なテーブルがたくさんあり、すでに作業したいテーブルが決まっている場合、このプロパティを使用して対象のテーブルのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。

Note：複数のスキーマまたはカタログを持つデータソースに接続する場合は、表示する各テーブルを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するテーブルが混同されることを防ぎます。

Views

レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。

解説

データベースによっては、利用可能なすべてのビューをリストするのに時間がかかり、パフォーマンスが低下する場合があります。接続文字列にビューのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

利用可能なビューがたくさんあり、すでに作業したいビューが決まっている場合、このプロパティを使用して対象のビューのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。

Note：複数のスキーマまたはカタログを持つデータソースに接続する場合は、確認する各ビューを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するビューが混同されることを防ぎます。

Miscellaneous

このセクションでは、本プロバイダーの接続文字列で設定可能なMiscellaneous プロパティの全リストを提供します。

プロパティ	説明
DirectoryRetrievalDepth	Specify how many folders deep you want to get results for Files table. The resources directly in the root are located at depth 0. The resources one folder deeper are located at depth 1 and so on. You can specify the value -1 to get all the data in a drive no matter the depth they're in.
MaxRows	集計やGROUP BY を使用しないクエリで返される最大行数を指定します。
Other	特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。
Pagesize	Microsoft Office 365 から返される、1ページあたりの結果の最大数を指定します。この設定は、ほとんどのユースケースに最適化されている、データソースによって設定されたデフォルトのページサイズをオーバーライドします。
PseudoColumns	テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。
Timeout	provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。
UseClientSidePaging	Whether or not the CData ADO.NET Provider for Microsoft Office 365 should use client side paging.
UserDefinedViews	カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。

DirectoryRetrievalDepth

Specify how many folders deep you want to get results for Files table. The resources directly in the root are located at depth 0. The resources one folder deeper are located at depth 1 and so on. You can specify the value -1 to get all the data in a drive no matter the depth they're in.

解説

This property must be set in the connection string or the driver will use a default of DirectoryRetrievalDepth=5.

MaxRows

集計やGROUP BY を使用しないクエリで返される最大行数を指定します。

解説

このプロパティは、集計やGROUP BY 句を含まないクエリに対してSync App が返す行数の上限を設定します。この制限により、クエリがデフォルトで過度に大きな結果セットを返さないようにします。

クエリにLIMIT 句が含まれている場合、クエリで指定された値がMaxRows 設定よりも優先されます。 MaxRows が"-1" に設定されている場合、LIMIT 句が明示的にクエリに含まれていない限り、行の制限は行われません。

このプロパティは、非常に大きなデータセットを返す可能性のあるクエリを実行する際に、パフォーマンスを最適化し過剰なリソース消費を防ぐのに役立ちます。

Other

特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。

解説

このプロパティは、シニアユーザーが特定のシナリオに対して隠しプロパティを設定できるようにします。これらの設定は通常のユースケースには必要ありませんが、特定の要件に対応したり、追加の機能を提供したりすることができます。複数のプロパティをセミコロン区切りのリストで定義できます。

Note： 特定のシナリオや問題に対処するためにサポートチームから助言があった場合にのみ、これらのプロパティを設定することを強く推奨します。

複数のプロパティをセミコロン区切りリストで指定します。

統合およびフォーマット


DefaultColumnSize	データソースがメタデータにカラムの長さを提供しない場合に、文字列フィールドのデフォルトの長さを設定します。デフォルト値は2000です。
ConvertDateTimeToGMT	日時の値を、マシンのローカルタイムではなくGMT グリニッジ標準時に変換するかどうかを決定します。
RecordToFile=filename	基底のソケットデータ転送を指定のファイルに記録します。

Pagesize

Microsoft Office 365 から返される、1ページあたりの結果の最大数を指定します。この設定は、ほとんどのユースケースに最適化されている、データソースによって設定されたデフォルトのページサイズをオーバーライドします。

解説

クエリする特定のオブジェクトやサービスエンドポイントの結果を最適化するために、デフォルトのページサイズを調整したい場合があります。ページサイズを大きくするとパフォーマンスが向上するかもしれませんが、ページあたりのメモリ消費量が増える可能性もあることに注意してください。

PseudoColumns

テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。

解説

このプロパティを使用すると、Sync App がテーブルカラムとして公開する擬似カラムを定義できます。

個々の擬似カラムを指定するには、以下の形式を使用します。"Table1=Column1;Table1=Column2;Table2=Column3"

すべてのテーブルのすべての擬似カラムを含めるには、次のようにします："*=*"

Timeout

provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。

解説

このプロパティは、Sync App が操作をキャンセルする前に操作の完了を待機する最大時間を秒単位で制御します。操作の完了前にタイムアウト時間が経過すると、Sync App は操作をキャンセルして例外をスローします。

タイムアウトは、クエリや操作全体ではなくサーバーとの個々の通信に適用されます。例えば、各ページング呼び出しがタイムアウト制限内に完了する場合、クエリは60秒を超えて実行を続けることができます。

このプロパティを0に設定するとタイムアウトが無効になり、操作が成功するか、サーバー側のタイムアウト、ネットワークの中断、またはサーバーのリソース制限などの他の条件で失敗するまで無期限に実行されます。このプロパティは慎重に使用してください。長時間実行される操作がパフォーマンスを低下させたり、応答しなくなる可能性があるためです。

UseClientSidePaging

Whether or not the CData ADO.NET Provider for Microsoft Office 365 should use client side paging.

解説

Some sources do not support server side paging. In these cases, set UseClientSidePaging to true. Otherwise, leave it as false. Setting UseClientSidePaging to true on a source that already supports paging can cause incomplete results.

UserDefinedViews

カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。

解説

このプロパティを使用すると、UserDefinedViews.json というJSON 形式の構成ファイルを通じてカスタムビューを定義および管理できます。これらのビューはSync App によって自動的に認識され、標準のデータベースビューのようにカスタムSQL クエリを実行できるようになります。 JSON ファイルは、各ビューをルート要素として定義し、その子要素として"query" を持ちます。この"query" にはビューのSQL クエリが含まれています。次に例を示します。

{
	"MyView": {
		"query": "SELECT * FROM Events WHERE MyColumn = 'value'"
	},
	"MyView2": {
		"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
	}
}

このプロパティを使用して、1つのファイルに複数のビューを定義し、ファイルパスを指定できます。例：UserDefinedViews=C:\Path\To\UserDefinedViews.json。このプロパティを使用すると、指定されたビューのみがSync App によって検知されます。

詳しくは、ユーザー定義ビューを参照してください。

Microsoft Office 365 Connector for CData Sync

Microsoft Office 365 Connector for CData Sync

概要

Microsoft Office 365 バージョンサポート

接続の確立

Microsoft Office 365 への接続を追加

Microsoft Office 365 への認証

Azure AD

Azure サービスプリンシパル

Managed Service Identity (MSI)

User-Managed Identities

管理タスク

UserId カラム

高度な機能

ユーザー定義ビュー

SSL の設定

ファイアウォールとプロキシ

クエリ処理

ログ

SSL の設定

SSL 設定のカスタマイズ

ファイアウォールとプロキシ

Firewall またはProxy 経由の接続

HTTP プロキシ

その他のプロキシ

データモデル

テーブル

ストアドプロシージャ

テーブル

Microsoft Office 365 Connector for CData Sync テーブル

Calendars

Table Specific Information

Select

Insert

Columns

Contacts

テーブル固有の情報

Select

Insert

Columns

Conversations

テーブル固有の情報

Select

Insert

Columns

Events

テーブル固有の情報

Select

Insert

Columns

Files

テーブル固有の情報

Select

INSERT

Columns

Groups

テーブル固有の情報

Select

Insert

Columns

Messages

テーブル固有の情報

Select

Insert

Update

Preserving HTML Formatting

Known Issues

Columns

Tasks

Table Specific Information

Select

Insert

Update

Delete

Columns

Users

テーブル固有の情報

Select

Insert

Columns