はじめに

このページでは、CData Cloud でのMicrosoft Exchange への接続の確立のガイド、利用可能なリソースに関する情報、および使用可能な接続プロパティのリファレンスについて説明します。

Microsoft Exchange への接続

接続の確立は、CData Cloud にデータベースを作成するためのMicrosoft Exchange への認証方法と必要な接続プロパティの設定方法について示します。

CData Cloud サービスからデータにアクセス

利用可能な標準サービスを経由してMicrosoft Exchange からデータにアクセスする方法と、CData Cloud の管理については、CData Cloud ドキュメントで詳しく説明します。

接続の確立

Database タブで対応するアイコンを選択して、Microsoft Exchange に接続します。必須プロパティはSettings にリストされています。Advanced タブには、通常は必要ない接続プロパティが表示されます。

Microsoft Exchange への接続

Exchange への接続には2つのスキーマがあります。

Exchange Web Services（EWS）は現在更新されていませんが、Exchange OnPremise とExchange Online の両方で利用できます。
Note：Microsoft は、Exchange Online ユーザーに対してMicrosoft Graph への切り替えを推奨しています。
Microsoft Graph

それぞれのスキーマのデータモデルについては、［データモデル］を参照してください。

EWS とMicrosoft Graph を切り替えるには、Schema をEWS またはMSGraph に設定します。

EWS の使用を続けるExchange Online ユーザーは、Schema をEWS に設定し、Platform をExchange_Online に設定します。

Exchange Online

Exchange Online は、以下で説明するようにOAuth による認証をサポートしています。（Azure AD およびAzure サービスプリンシパルは、認証にカスタムOAuth アプリケーションも使用します。）

EWS を介してExchange Online プラットフォームに接続する場合は、AuthScheme をAzureAD、AzureServicePrincipal、 AzureMSI のいずれかに設定します。

Microsoft Graph を介してExchange Online に接続する場合は、Schema をMSGraph に設定します。

Microsoft Exchange への認証

Microsoft Exchange は、OAuth（Azure AD およびAzure サービスプリンシパル）、Managed Service Identity（MSI）、Kerberos を使用する認証をサポートします。

OAuth

Azure AD およびAzure サービスプリンシパルは、どちらもOAuth ベースの認証を必要とします。

Azure AD

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

Microsoft Exchange は埋め込みOAuth クレデンシャルを提供しており、デスクトップアプリケーションからの接続を簡単にします。Web アプリケーションから接続するには、カスタムOAuth アプリケーションの作成で説明するようにカスタムOAuth アプリケーションを作成する必要があります。

すべての認証フローで、OAuth 経由で接続するにはAuthScheme をOAuth に設定する必要があります。

以下のサブセクションでは、該当するすべての認証フローからのMicrosoft Exchange への認証について詳しく説明します。カスタムOAuth アプリケーションの作成についての情報と、すでに埋め込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、カスタムOAuth アプリケーションの作成を参照してください。Microsoft Exchange で利用可能な接続文字列プロパティの全リストは、Connection を参照してください。

アクセストークンの期限が切れたときは、Cloud は自動でアクセストークンをリフレッシュします。

Azure サービスプリンシパル

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

Azure サービスプリンシパル認証の設定方法については、カスタムOAuth アプリケーションの作成を参照してください。

クライアントシークレットによる認証

OAuth は、認証のためのクライアント資格情報の使用をサポートします。クライアント資格情報のOAuth フローでは、認証するアプリケーション自身の資格情報が作成されます。認証フローは通常の認証フローと同じように動作しますが、関連するユーザーに対して資格情報の提供を求めるプロンプトは表示されません。アプリケーションで受理されるすべてのタスクは、デフォルトユーザーコンテキストなしで実行されます。

Note： 埋め込まれたOAuth 資格情報はユーザーごとに認証されるため、クライアントOAuth フローで使用することはできません。クライアント資格情報を使用するには、必ずカスタムOAuth アプリケーションを作成する必要があります。

クライアント資格情報で認証するには、カスタムOAuth アプリケーションを使用する必要があります。詳しくは、カスタムOAuth アプリケーションの作成を参照してください。

次のパラメータを設定して、接続してください。

AuthScheme：AzureServicePrincipal。
InitiateOAuth：GETANDREFRESH。InitiateOAuth を使うと、OAuth 交換の繰り返しや、手動でのOAuthAccessToken 設定を避けられます。
AzureTenant：接続するテナント。
OAuthGrantType：CLIENT。
OAuthClientId：アプリケーション設定のクライアントId。
OAuthClientSecret：アプリケーション設定のクライアントシークレット。

クライアント資格情報での認証は、他の接続同様に自動的に行われますが、ユーザーにログインを促すウィンドウは表示されません。ユーザーコンテキストがないため、ブラウザのポップアップは必要ないからです。接続は内部で行われ、処理されます。

Managed Service Identity (MSI)

Azure VM 上でMicrosoft Exchange を実行しており、MSI を利用して接続したい場合は、AuthScheme をAzureMSI に設定します。

User-Managed Identities

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

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

Kerberos

Kerberos 経由でMicrosoft Exchange への認証を行うには、認証プロパティを定義し、Kerberos が認証チケットを取得する方法を選択する必要があります。

Kerberos を使用してMicrosoft Exchange への認証を行うには、次のプロパティを設定します。

hive.server2.authentication: Kerberos。
AuthScheme：NEGOTIATE。
KerberosKDC：Kerberos KDC マシンのホスト名またはIP アドレス。
KerberosRealm：Microsoft Exchange Kerberos プリンシパルのレルム。この値は、主たる値の'@' 記号のすぐ後にあります。
KerberosSPN：Microsoft Exchange のKerberos プリンシパルのサービスとホスト。この値は、主たる値の'@' 記号のすぐ前にあります。

Kerberos をMicrosoft Exchange 環境で使用する方法の詳細については、Kerberos の使用を参照してください。

Azure サービスプリンシパルの使用

Azure サービスプリンシパル

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

Azure サービスプリンシパル認証を使用するには、以下を行います。

認証アプリケーションにロールを割り当てる機能を設定します。これには、カスタムOAuth アプリケーションの作成で説明するように、カスタムOAuth AD アプリケーションを作成します。
Azure AD テナントにアプリケーションを登録し、ロールベースのアクセス制御で使用できる新しいサービスプリンシパルを作成して、サブスクリプション内のリソースにアクセスします。

以下の手順に従います。

カスタムOAuth アプリケーションの作成での説明のとおりに、カスタムAzure AD アプリケーションを作成します。
アプリケーションへのロールの割り当て：
1. 検索バーを使用してサブスクリプションサービスを検索します。
2. サブスクリプションページを開きます。
3. アプリケーションを割り当てるサブスクリプションを選択します。
4. アクセス制御（IAM）を開きます。
5. 追加 -> ロールの割り当ての追加を選択します。Microsoft Exchange はロールの割り当ての追加ページを開きます。
6. 作成したカスタムAzure AD アプリケーションに所有者ロールを割り当てます。

管理者の同意

管理者の同意は、Azure Active Directory テナントの管理者が、管理者の同意を明示的に必要とするカスタムアプリケーションに権限を付与する場合に行います。

Azure ポータルで新しいAzure AD アプリケーションを作成する場合には、アプリケーションに必要なアクセス許可を指定する必要があります。一部のアクセス許可には、「管理者の同意が必要」と記載されている場合があります。例えば、すべてのグループのアクセス許可には管理者の同意が必要です。アプリケーションが管理者の同意を必要とする場合、方法は2つあります。

管理者の同意を付与する最も簡単な方法は、管理者がportal.azure.com にログインして、アプリの登録で作成したアプリケーションに移動することです。API のアクセス許可で、 同意の付与をクリックします。これにより、アプリケーションが作成されたテナントにアクセス権限が付与されます。

組織に複数のテナントがある場合、または組織外の他のテナントにアプリのアクセス許可を与える必要がある場合、GetAdminConsentURL ストアドプロシージャを使用してAdmin Authorization URL を生成します。GetOAuthAuthorizationURL ストアドプロシージャとは異なり、このエンドポイントから返される重要な情報はありません。代わりに、OAuth アプリケーションが正常に認可されると、アクセス権限が付与されたことを示すBoolean 値が返されます。

管理者がOAuth アプリケーションを承認後、認証を続行できます。

クライアントクレデンシャル

クライアント資格情報は、直接ユーザー認証が行われないOAuth のフローを指します。代わりに、クレデンシャルはアプリケーション自体のためだけに作成されます。アプリケーションで実行されるすべてのタスクは、デフォルトユーザーコンテキストなしで実行されます。そのため、認証フローが標準フローとは少し違ったものになります。

クライアントOAuth フローに関連するすべてのアクセス許可には、管理者の同意が必要です。これは、CData Cloud が埋め込まれたアプリケーションをクライアントOAuth フローでは使用できないことを意味します。クライアント資格情報を使用するには、独自のOAuth アプリケーションの作成が必要になります。詳しくは、カスタムOAuth アプリケーションの作成を参照してください。

portal.azure.com の［アプリの登録］で［API のアクセス許可］に移動し、Microsoft Graph アクセス許可を選択します。アクセス許可には2つの異なるアクセス許可セットがあります。委任されたアクセス許可とアプリケーションの許可です。クライアントの資格情報認証時に使用されるアクセス許可は、［アプリケーションの許可］の下にあります。

インテグレーションに必要なアクセス許可を選択します。その後、次の接続プロパティを設定します。

AuthScheme：AzureServicePrincipal。
InitiateOAuth：GETANDREFRESH。InitiateOAuth を使うと、OAuth 交換の繰り返しや、手動でのOAuthAccessToken 設定を避けられます。
AzureTenant：接続するテナント。
OAuthGrantType：CLIENT。
OAuthClientId：アプリケーション設定のクライアントId。
OAuthClientSecret：アプリケーション設定のクライアントシークレット。

クライアント資格情報での認証は、他の接続同様に自動的に行われますが、ユーザーにプロンプトするウィンドウは表示されません。ユーザーコンテキストがないため、ブラウザのポップアップは必要ないからです。接続が行われ、内部的に処理されます。

Kerberos の使用

Kerberos

Kerberos でMicrosoft Exchange への認証を行うには、AuthScheme をNEGOTIATE に設定します。

Kerberos 経由でMicrosoft Exchange への認証を行うには、認証プロパティを定義し、Kerberos が認証チケットを取得する方法を選択する必要があります。

Kerberos チケットの取得

Kerberos チケットは、依頼者のID を認証するために使用されます。正式なログイン / パスワードの代わりにチケットを使用することで、パスワードをローカルに保存したり、ネットワーク経由で送信したりする必要がなくなります。ユーザーは、ローカルコンピュータでログインするか、コマンドプロンプトでkinit USER と入力するたびに、再認証されます（チケットはリフレッシュされます）。

Cloud は、 KRB5CCNAME および / またはKerberosKeytabFile 変数が存在するかどうかに応じて、必要なKerberos チケットを取得する3 つの方法を提供します。

MIT Kerberos 資格情報キャッシュファイル

このオプションを使用すると、MIT Kerberos チケットマネージャーまたはkinit コマンドを使ってチケットを取得できます。このオプションでは、User またはPassword 接続プロパティを設定する必要はありません。

このオプションは、KRB5CCNAME がシステムに作成されている必要があります。

MIT Kerberos 資格情報キャッシュファイル経由でチケット検索を有効にするには：

お使いの環境にKRB5CCNAME 変数が存在することを確認します。
KRB5CCNAME を資格情報キャッシュファイルを指すパスに設定します。（例えば、C:\krb_cache\krb5cc_0 または/tmp/krb5cc_0 です。）資格情報キャッシュファイルは、MIT Kerberos チケットマネージャーを使用してチケットを生成するときに作成されます。
チケットを取得するには：
1. MIT Kerberos チケットマネージャーアプリケーションを開きます。
2. Get Ticket をクリックします。
3. プリンシパル名とパスワードを入力します。
4. OK をクリックします。
チケットの取得に成功すると、チケット情報がKerberos チケットマネージャーに表示され、クレデンシャルキャッシュファイルに保存されます。

Cloud はキャッシュファイルを使用してMicrosoft Exchange に接続するためのKerberos チケットを取得します。

Note： KRB5CCNAME を編集したくない場合は、KerberosTicketCache プロパティを使用してファイルパスを手動で設定することができます。この設定後に、Cloud は指定されたキャッシュファイルを使用してMicrosoft Exchange に接続するためのKerberos チケットを取得します。

Keytab ファイル

お使いの環境にKRB5CCNAME 環境変数がない場合、Keytab ファイルを使用してKerberos チケットを取得できます。

この方法を使用するには、User プロパティを目的のユーザー名に設定し、KerberosKeytabFile プロパティをユーザーに関連付けられたキータブファイルを指すファイルパスに設定します。

User およびPassword

お使いの環境にKRB5CCNAME 環境変数およびKerberosKeytabFile プロパティが設定されていない場合、ユーザーとパスワードの組み合わせを使用してチケットを取得できます。

この方法を使用するには、User およびPassword プロパティを、Microsoft Exchange での認証に使用するユーザー / パスワードの組み合わせに設定します。

クロスレルム認証の有効化

より複雑なKerberos 環境では、複数のレルムおよびKDC サーバーが使用されるクロスレルム認証が必要になる場合があります。例えば、1つのレルム / KDC がユーザー認証に使用され、別のレルム / KDC がサービスチケットの取得に使用される場合です。

このようなクロスレルム認証を有効にするには、KerberosRealm およびKerberosKDC プロパティをユーザー認証に必要な値に設定します。また、KerberosServiceRealm およびKerberosServiceKDC プロパティを、サービスチケットの取得に必要な値に設定します。

Exchange Online の管理タスク

CData Cloud を使用してMSGraph Schema で管理タスクを実行できます。これは、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 を設定することはお勧めできません。

Note：特定のクエリの'OR' 演算子と組み合わせてUserId を指定することはサポートされていません。別の方法として、'UNION' を使うと同じ結果セットを取得できます。

Exchange データの選択

Note：以下は、Schema がEWS に設定されているときの動作について説明します。MSGraph には影響しません。

FindItem vs. GetItem

デフォルトで、Cloud はExhange Web Services FindItem API を呼び出し、SELECT 処理の実行時にはアイテムのサマリー情報のみをリクエストします。二つ以上のアイテムを返すリクエストはすべてサマリー情報を返します。次に例を示します。

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE Surname='Smith'

メッセージの内容、もしくは連絡先やカレンダーイベントの詳細情報をリクエストするには、IncludeContent をTRUE に設定するか、アイテムのItemId を指定するか、結果を一つのアイテムに制限する必要があります。次に例を示します。

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE ItemId='AZQ111222...'

OR

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE ItemdId IN ('AZQ111222...', 'AZQ111223...', 'AZQ111224...', 'AZQ111225...')

OR

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE Surname='Smith' LIMIT 1

パブリック、およびカスタムフォルダ

パブリック、もしくはカスタムフォルダから読み出す場合は、まず読み出すフォルダのFolderId を指定する必要があります。これは、ParentFolder （カスタムフォルダの）から、もしくはパブリックフォルダに保存されているオブジェクトのタイプに合うテーブルからの読み出しクエリを出します。パブリックフォルダがメッセージを保有する場合には Inbox を使います。次に例を示します。

Inbox のサブフォルダのFolderId を探す：

SELECT DisplayName, FolderId FROM Inbox

Contact を含むカスタムフォルダのFolderId を探す：

SELECT DisplayName, FolderId FROM Contacts WHERE ParentFolderName='publicfoldersroot'

パブリックフォルダがネストされている場合、親カスタムフォルダには別のSELECT クエリをする必要があります。

SELECT DisplayName, FolderId FROM Contacts WHERE ParentFolderId='AAEuAAAAAAAa...'

パブリックフォルダとカスタムフォルダでのアイテムの作成

パブリック、およびカスタムフォルダへの挿入

パブリック、もしくはカスタムフォルダの中にアイテムを作成する場合は、まず読み出すフォルダのFolderId を指定する必要があります（Exchange データの選択を参照）。 FolderId がわかれば、新しいオブジェクトを作成する際のParentFolderId の値として使用できます。カスタム、もしくはパブリックフォルダの中にオブジェクトを作成する場合、テーブルに適切なオブジェクトタイプを使用します（もしくは、Message を含むフォルダであればInbox を使います）。次に例を示します。

Inbox のサブフォルダへの挿入：

INSERT INTO Inbox (Subject, FromEmailAddress, ToRecipients_EmailAddress, ParentFolderId) VALUES ('New email message', '[email protected]', '[email protected]', 'AAEuAAAAAAAa...')

Contact を含むパブリックフォルダへの挿入：

INSERT INTO Contacts (GivenName, Surname, EmailAddress1, ParentFolderId) VALUES ('Jill', 'Smith', '[email protected]', 'AAEuAAAAAAAa...')

パブリックフォルダとカスタムフォルダでのアイテムの更新および削除

パブリックおよびカスタムフォルダのItem の更新および削除

パブリック、もしくはカスタムフォルダからの読み出しや書き込みとは異なり、アイテムの更新や削除にはFolderId は不要です。フォルダがどのようなタイプのオブジェクトを保有しているかを知っていれば、そのタイプをテーブルとして利用できます（もしくはメッセージを含むフォルダにはInbox を使います）。次に例を示します。

カスタムフォルダのメッセージアイテムの更新：

UPDATE Inbox SET Subject = 'Updated email message' WHERE ItemID = 'AZQ111222...')

パブリックフォルダのContact アイテムの削除：

DELETE FROM Contacts WHERE ItemID = 'AZQ111222...')

データアクセスのファインチューニング

ユーザーの偽装

この認証方法は、通常は管理者がサービスアカウントによるアクセスを構成するために使用されます。
すべてのリクエストを偽装するには、接続時に次の接続プロパティを設定します。
個々のクエリに対してユーザーを偽装するには、同じ名前の疑似カラムを使用します。

ImpersonationUser：偽装するユーザーに設定。
ImpersonationType：ユーザーを指定するために使用している形式に設定。例えば、UPN またはSID。

SSL の設定

SSL 設定のカスタマイズ

デフォルトでは、Cloud はサーバーの証明書をシステムの信頼できる証明書ストアと照合してSSL / TLS のネゴシエーションを試みます。

別の証明書を指定するには、利用可能なフォーマットについてSSLServerCert プロパティを参照してください。

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

Firewall またはProxy 経由の接続

HTTP プロキシ

Windows のシステムプロキシ経由の接続では、接続プロパティを追加で設定する必要はありません。他のプロキシに接続するには、ProxyAutoDetect をfalse に設定します。

さらにHTTP プロキシへの認証には、ProxyServer とProxyPort に加えてProxyAuthScheme、ProxyUser、およびProxyPassword を設定します。

その他のプロキシ

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

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

データモデル

CData Cloud は、Microsoft Exchange 2 およびMicrosoft Exchange API をリレーショナルテーブル、ビュー、およびストアドプロシージャとしてモデル化します。これらは、簡単なテキストベースのコンフィギュレーションファイルであるスキーマファイルにて定義されます。

利用可能なエンティティ、およびこれらのエンティティをクエリするためのAPI の制限および要件については、EWS データモデルおよびMSGraph データモデルで説明します。

概要

データモデルは、Microsoft Exchange 環境がどのように見えるかの例を示します。実際のデータモデルは、Microsoft Exchange アカウントに基づいて動的に取得されます。

主要機能

テーブルおよびビューは、Microsoft Exchange のカレンダー、ドキュメント、プロジェクトをモデル化するために動的に定義されます。
ストアドプロシージャを使用すると、オブジェクトのダウンロードやアップロードなど、Microsoft Exchange の操作を実行できます。
これらのオブジェクトへのライブ接続により、Cloud を使用するとMicrosoft Exchange アカウントへのあらゆる変更が即座に反映されます。

EWS データモデル

EWS データモデルでは、EWS を使用してMicrosoft Exchange OnPremise およびMicrosoft Exchange Online に接続するために使用できるスキーマについて説明します。テーブルを使用して、ライブMicrosoft Exchange データを操作できます。CData Cloud が提供するストアドプロシージャを使用して、Microsoft Exchange データの操作を自動化できます。

MSGraph データモデル

MSGraph データモデルでは、Microsoft Graph 経由でMicrosoft Exchange Online アカウントに接続するために使用できるスキーマについて説明します。テーブルを使用して、ライブMicrosoft Exchange データを操作できます。CData Cloud が提供するストアドプロシージャを使用して、Microsoft Exchange データの操作を自動化できます。

EWS データモデル

CData Cloud は、Microsoft Exchange エンティティをリレーショナルなテーブルおよびストアドプロシージャにモデル化します。これらは、簡単なテキストベースのコンフィギュレーションファイルであるスキーマファイルにて定義されます。

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

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

テーブル

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

CData Cloud - Microsoft Exchange テーブル


Name	Description
Calendar	Create, update, delete, and query Calendar items.
Calendar_OptionalAttendees	The optional attendees for a particular event. An ItemId must be specified when querying this view.
Calendar_RequiredAttendees	The required attendees for a particular event. An ItemId must be specified when querying this view.
Contacts	Create, update, delete, and query Contacts items.
DeletedItems	Create, update, delete, and query Deleted Items.
Drafts	Create, update, delete, and query Drafts items.
Folders	Create, update, delete, and query subfolders for a given folder.
Inbox	Create, update, delete, and query Inbox items.
JunkEmail	Create, update, delete, and query Junk Email items.
Outbox	Create, update, delete, and query Outbox items.
SentItems	Create, update, delete, and query Sent Items.
Tasks	Create, update, delete, and query Tasks items.

Calendar

Create, update, delete, and query Calendar items.

テーブル固有の情報

Update およびDelete

Cloud では、アイテムの更新および削除にはItemChangeKey が必要です。ただし、ItemChangeKey が不明な場合には、Cloud は自動的にExchange サーバーからこれを取得することができます。これはクエリ実行にかかる時間を増加させることに注意してください。

定期イベントを選択

Calendar テーブルでSELECT 処理を実行するとき、Cloud は個別の定期的なイベントをデフォルトで含めません（マスターアイテムのみが含まれます）。クエリには次のようなWHERE 句を含む必要があります：

SELECT Subject, IsRecurring, Recurrence_StartDate, Recurrence_EndDate, Recurrence_Interval, Recurrence_Type, Recurrence_NumberOfOccurrences, FirstOccurrence_Start FROM Calendar WHERE ItemId = 'myid'

If you wish to view the individual recurrences of a recurring event, you'll need to add filters START and END with greaterthan and lessthan operators respectively. The interval between START and END should not be more than 2 years. The API will return atmost 1000 entries for recurring events. Please give the interval between START and END filters accordingly. Your query will need to include a WHERE clause similar to the following:

SELECT * FROM Calendar WHERE start >= '2021-05-11 00:50:59.0' AND end <= '2023-02-28 11:20:30.0'

Columns


Name	Type	ReadOnly	Description
ItemId [KEY]	String	True	Contains the unique identifier of an item in the Exchange store. This property is read-only.
MimeContent	String	True	Contains the native Multipurpose Internet Mail Extensions (MIME) stream of an object that is represented in Base64 binary format.
ItemChangeKey	String	True	Contains the unique change key of an item in the Exchange store. This property is read-only.
ParentFolderId	String	False	Represents the unique identifier of the parent folder that contains the item or folder. This property is read-only.
ParentFolderChangeKey	String	True	Represents the unique change key of the parent folder that contains the item or folder. This property is read-only.
ItemClass	String	False	Represents the message class of an item.
Subject	String	False	Represents the subject for Exchange store items and response objects. The subject is limited to 255 characters.
Sensitivity	String	True	Indicates the sensitivity level of an item.
Body	String	False	Body of the Calendar Item.
DateTimeReceived	Datetime	True	Represents the date and time that an item in a mailbox was received.
Size	Integer	True	Represents the size in bytes of an item. This property is read-only.
Categories	String	False	Represents a collection of strings that identify to which categories an item in the mailbox belongs.
Importance	String	False	Describes the importance of an item.
InReplyTo	String	True	Represents the identifier of the item to which this item is a reply.
IsSubmitted	Boolean	True	Indicates whether an item has been submitted to the Outbox default folder.
IsDraft	Boolean	True	Represents whether an item has not yet been sent.
IsFromMe	Boolean	True	Indicates whether a user sent an item to himself or herself.
IsResend	Boolean	True	Indicates whether the item had previously been sent.
IsUnmodified	Boolean	True	Indicates whether the item has been modified.
InternetMessageHeaders	String	True	Represents the collection of all Internet message headers that are contained within an item in a mailbox.
DateTimeSent	Datetime	True	Represents the date and time that an item in a mailbox was sent.
DateTimeCreated	Datetime	True	Represents the date and time that a given item in the mailbox was created.
ReminderDueBy	Datetime	False	Represents the date and time when the event occurs.
ReminderIsSet	Boolean	False	Indicates whether a reminder has been set for an item in the Exchange store.
ReminderMinutesBeforeStart	Integer	False	Represents the number of minutes before an event occurs when a reminder is displayed.
DisplayCc	String	True	Represents the display string that is used for the contents of the To box. This is the concatenated string of all To recipient display names.
DisplayTo	String	True	Represents a property that is set to true if an item has at least one visible attachment. This property is read-only.
HasAttachments	Boolean	True	Indicates whether an item has attachments.
Culture	String	False	Represents the Culture of an item.
Start	Datetime	False	Represents the start of a duration.
End	Datetime	False	Represents the end of a duration.
OriginalStart	Datetime	False	Represents the original start time of a calendar item.
IsAllDayEvent	Boolean	False	Indicates whether a calendar item or meeting request represents an all-day event.
LegacyFreeBusyStatus	String	False	Represents the free/busy status of the calendar item.
Location	String	False	Represents the location of a meeting, appointment, or persona.
When	String	False	Provides information about when a calendar or meeting item occurs.
IsMeeting	Boolean	False	Indicates whether the calendar item is a meeting or an appointment.
IsCancelled	Boolean	False	Indicates whether an appointment or meeting has been cancelled.
IsRecurring	Boolean	True	Indicates whether a calendar item, meeting request, or task is part of a recurring item. This element is read-only.
MeetingRequestWasSent	Boolean	True	Indicates whether a meeting request has been sent to requested attendees.
IsResponseRequested	Boolean	True	Indicates whether a response to an item is requested.
CalendarItemType	String	True	Represents the type of a calendar item.
MyResponseType	String	False	Contains the status of or response to a calendar item.
OrganizerName	String	False	Defines the name of the mailbox user.
OrganizerEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the Organizer mailbox user.
OrganizerRoutingType	String	False	Defines the routing that is used for the Organizer mailbox. The default is SMTP.
ConflictingMeetingCount	Integer	True	Represents the number of meetings that conflict with the calendar item.
AdjacentMeetingCount	Integer	True	Represents the total number of calendar items that are adjacent to a meeting time.
Duration	String	True	Represents the duration of a calendar item.
TimeZone	String	True	Provides a text description of a time zone.
AppointmentReplyTime	Datetime	False	Represents the date and time that an attendee replied to a meeting request.
AppointmentSequenceNumber	String	False	Specifies the sequence number of a version of an appointment.
AppointmentState	String	True	Specifies the status of the appointment.
Recurrence_Type	String	False	Contains the recurrence type for calendar items and meeting requests. 使用できる値は次のとおりです。RelativeYearlyRecurrence, AbsoluteYearlyRecurrence, RelativeMonthlyRecurrence, AbsoluteMonthlyRecurrence, WeeklyRecurrence, DailyRecurrence
Recurrence_DaysOfWeek	String	False	Describes days of the week that are used in item recurrence patterns.
Recurrence_DayOfWeekIndex	String	False	Describes which week in a month is used in a relative yearly recurrence pattern. 使用できる値は次のとおりです。First, Second, Third, Fourth, Last
Recurrence_Month	String	False	Describes the month when a yearly recurring item occurs.
Recurrence_DayOfMonth	Integer	False	Describes the day in a month on which a recurring item occurs.
Recurrence_Interval	Integer	False	Defines the interval between two consecutive recurring items.
Recurrence_FirstDayOfWeek	String	False	Specifies the first day of the week.
Recurrence_Duration	String	False	Contains the recurrence duration type for calendar items and meeting requests. 使用できる値は次のとおりです。NoEndRecurrence, EndDateRecurrence, NumberedRecurrence
Recurrence_StartDate	Date	False	Represents the start date of a recurring task or calendar item.
Recurrence_EndDate	Date	False	Represents the end date of a recurring task or calendar item.
Recurrence_NumberOfOccurrences	Integer	False	Contains the number of occurrences of a recurring item.
FirstOccurrence_ItemId	String	False	Contains the unique identifier of the last occurrence of a recurring calendar item.
FirstOccurrence_Start	Datetime	False	Represents the start time of the last occurrence of a recurring calendar item.
FirstOccurrence_End	Datetime	False	Represents the end time of the last occurrence of a recurring calendar item.
FirstOccurrence_OriginalStart	Datetime	False	Represents the original start time of the last occurrence of a recurring calendar item.
LastOccurrence_ItemId	String	False	Contains the unique identifier of the last occurrence of a recurring calendar item.
LastOccurrence_Start	Datetime	False	Represents the start time of the last occurrence of a recurring calendar item.
LastOccurrence_End	Datetime	False	Represents the end time of the last occurrence of a recurring calendar item.
LastOccurrence_OriginalStart	Datetime	False	Represents the original start time of the last occurrence of a recurring calendar item.
ModifiedOccurrences_Aggregate	String	True	Modified occurrences of the calendar, as aggregate.
DeletedOccurrences_Aggregate	String	True	Deleted occurrences as aggregate.
StartTimeZone_Id	String	True	Represents the unique identifier of the time zone definition for the start time.
StartTimeZone_Name	String	True	Represents the descriptive name of the time zone definition for the start time.
EndTimeZone_Id	String	True	Represents the unique identifier of the time zone definition for the end time.
EndTimeZone_Name	String	True	Represents the descriptive name of the time zone definition for the end time.
ConferenceType	Integer	False	Describes the type of conferencing that is performed with a calendar item (0 = NetMeeting, 1 = NetShow, 2 = Chat.
AllowNewTimeProposal	Boolean	False	Indicates whether a new meeting time can be proposed for a meeting by an attendee.
IsOnlineMeeting	Boolean	False	Indicates whether the meeting is online.
MeetingWorkspaceUrl	String	False	Contains the URL for the meeting workspace that is linked to by the calendar item.
NetShowUrl	String	False	Specifies the URL for a Microsoft NetShow online meeting.
EffectiveRights_CreateAssociated	Boolean	True	Indicates whether a client can create an associated contents table.
EffectiveRights_CreateContents	Boolean	True	Indicates whether a client can create a contents table.
EffectiveRights_CreateHierarchy	Boolean	True	Indicates whether a client can create a hierarchy table.
EffectiveRights_Delete	Boolean	True	Indicates whether a client can delete a folder or item.
EffectiveRights_Modify	Boolean	True	Indicates whether a client can modify a folder or item.
EffectiveRights_Read	Boolean	True	Indicates whether a client can read a folder or item.
EffectiveRights_ViewPrivateItems	Boolean	True	Indicates whether a private item can be viewed.
LastModifiedName	String	True	Contains the display name of the last user to modify an item.
LastModifiedTime	Datetime	True	Indicates when an item was last modified.
IsAssociated	Boolean	False	Indicates whether the item is associated with a folder.
WebClientReadFormQueryString	String	True	Represents a URL to concatenate to the Microsoft Office Outlook Web App endpoint to read an item in Outlook Web App.
WebClientEditFormQueryString	String	True	Represents a URL to concatenate to the Outlook Web App endpoint to edit an item in Outlook Web App.
ConversationId	String	True	Contains the identifier of an item or conversation.
ConversationChangeKey	String	True	Contains the change key of an item or conversation.
UniqueBody	String	True	Represents an HTML fragment or plain-text which represents the unique body of this conversation.
UniqueBodyType	String	True	Describes how the unique item body is stored in the item (HTML or TEXT).

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
ImpersonationUser	String	The Identifier of the user to impersonate.
ImpersonationType	String	The type of Identifier used for the impersonation user (PrincipalName, SID, PrimarySmtpAddress, SmtpAddress).
SendMeetingInvitations	String	The allowed values are SendToNone, SendOnlyToAll, and SendToAllAndSaveCopy. The default is SendToNone.
SendCancellationsMode	String	The allowed values are SendToNone, SendOnlyToAll, and SendToAllAndSaveCopy. The default is SendToNone.
SharedMailboxEmail	String	The email of a shared mailbox. Use this to retrieve the calendar events in a shared mailbox.

Calendar_OptionalAttendees

The optional attendees for a particular event. An ItemId must be specified when querying this view.

テーブル固有の情報

Update およびDelete

Cloud では、アイテムの更新および削除にはItemChangeKey が必要です。ただし、ItemChangeKey が不明な場合には、Cloud は自動的にExchange サーバーからこれを取得することができます。これはクエリ実行にかかる時間を増加させることに注意してください。

挿入

Calendar テーブルでSELECT 処理を実行するとき、Cloud は個別の定期的なイベントをデフォルトで含めません（マスターアイテムのみが含まれます）。定期的なイベントの個別の繰り返しを参照したい場合、IsRecurring カラムでフィルタリングを行い、Start およびEnd を指定して時間を指定する必要があります。クエリには次のようなWHERE 句を含む必要があります：

INSERT INTO Calendar_OptionalAttendees (EmailAddress, ItemId, SendMeetingInvitations) VALUES ('[email protected]', 'itemid', 'SendOnlyToChanged')

Columns


Name	Type	ReadOnly	Description
EmailAddress [KEY]	String	False
ItemId [KEY]	String	False
Name	String	False

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
ImpersonationUser	String	The Identifier of the user to impersonate.
ImpersonationType	String	The type of Identifier used for the impersonation user (PrincipalName, SID, PrimarySmtpAddress, SmtpAddress).
SendMeetingInvitations	String	The allowed values are SendToNone, SendOnlyToAll, SendOnlyToChanged and SendToAllAndSaveCopy. The default is SendToNone.

Calendar_RequiredAttendees

The required attendees for a particular event. An ItemId must be specified when querying this view.

テーブル固有の情報

挿入ステートメント

INSERT 操作を実行する場合は、EmailAddress およびItemId を指定する必要があります。また、SendMeetingInvitations というプロパティで、必要な出席者を挿入したときに誰に通知するかを決定できます。

INSERT INTO Calendar_RequiredAttendees (EmailAddress, ItemId, SendMeetingInvitations) VALUES ('[email protected]', 'itemid', 'SendOnlyToChanged')

Columns


Name	Type	ReadOnly	Description
EmailAddress [KEY]	String	False
ItemId	String	False
Name	String	False

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
ImpersonationUser	String	The Identifier of the user to impersonate.
ImpersonationType	String	The type of Identifier used for the impersonation user (PrincipalName, SID, PrimarySmtpAddress, SmtpAddress).
SendMeetingInvitations	String	The allowed values are SendToNone, SendOnlyToAll, SendOnlyToChanged and SendToAllAndSaveCopy. The default is SendToNone.

Contacts

Create, update, delete, and query Contacts items.

テーブル固有の情報

Update およびDelete

Cloud では、アイテムの更新および削除にはItemChangeKey が必要です。ただし、ItemChangeKey が不明な場合には、Cloud は自動的にExchange サーバーからこれを取得することができます。これはクエリ実行にかかる時間を増加させることに注意してください。

Columns


Name	Type	ReadOnly	Description
MimeContent	String	True	Contains the native Multipurpose Internet Mail Extensions (MIME) stream of an object that is represented in Base64 binary format.
ItemId [KEY]	String	True	Contains the unique identifier of an item in the Exchange store. This property is read-only.
ItemChangeKey	String	True	Contains the unique change key of an item in the Exchange store. This property is read-only.
ParentFolderId	String	False	Represents the unique identifier of the parent folder that contains the item or folder. This property is read-only.
ParentFolderChangeKey	String	True	Represents the unique change key of the parent folder that contains the item or folder. This property is read-only.
ItemClass	String	False	Represents the message class of an item.
Subject	String	False	Represents the subject for Exchange store items and response objects. The subject is limited to 255 characters.
Sensitivity	String	True	Indicates the sensitivity level of an item.
Body	String	False	Represents the actual body content of a message.
DateTimeReceived	Datetime	True	Represents the date and time that an item in a mailbox was received.
Size	Integer	True	Represents the size in bytes of an item. This property is read-only.
Categories	String	False	Represents a collection of strings that identify to which categories an item in the mailbox belongs.
Importance	String	False	Describes the importance of an item.
IsSubmitted	Boolean	True	Indicates whether an item has been submitted to the Outbox default folder.
InReplyTo	String	True	Represents the identifier of the item to which this item is a reply.
IsDraft	Boolean	True	Represents whether an item has not yet been sent.
IsFromMe	Boolean	True	Indicates whether a user sent an item to himself or herself.
IsResend	Boolean	True	Indicates whether the item had previously been sent.
IsUnmodified	Boolean	True	Indicates whether the item has been modified.
InternetMessageHeaders	String	True	Represents the collection of all Internet message headers that are contained within an item in a mailbox.
DateTimeSent	Datetime	True	Represents the date and time that an item in a mailbox was sent.
DateTimeCreated	Datetime	True	Represents the date and time that a given item in the mailbox was created.
ReminderDueBy	Datetime	False	Represents the date and time when the event occurs.
ReminderIsSet	Boolean	False	Indicates whether a reminder has been set for an item in the Exchange store.
ReminderMinutesBeforeStart	Integer	False	Represents the number of minutes before an event occurs when a reminder is displayed.
DisplayCc	String	True	Represents the display string that is used for the contents of the Cc box. This is the concatenated string of all Cc recipient display names.
DisplayTo	String	True	Represents the display string that is used for the contents of the To box. This is the concatenated string of all To recipient display names.
HasAttachments	Boolean	True	Represents a property that is set to true if an item has at least one visible attachment. This property is read-only.
Culture	String	False	Represents the culture for a given item in a mailbox.
EffectiveRights_CreateAssociated	Boolean	True	Indicates whether a client can create an associated contents table.
EffectiveRights_CreateContents	Boolean	True	Indicates whether a client can create a contents table.
EffectiveRights_CreateHierarchy	Boolean	True	Indicates whether a client can create a hierarchy table.
EffectiveRights_Delete	Boolean	True	Indicates whether a client can delete a folder or item.
EffectiveRights_Modify	Boolean	True	Indicates whether a client can modify a folder or item.
EffectiveRights_Read	Boolean	True	Indicates whether a client can read a folder or item.
EffectiveRights_ViewPrivateItems	Boolean	True	Indicates whether a private item can be viewed.
LastModifiedName	String	True	Contains the display name of the last user to modify an item.
LastModifiedTime	Datetime	True	Indicates when an item was last modified. This element is read-only.
IsAssociated	Boolean	False	Indicates whether the item is associated with a folder.
WebClientReadFormQueryString	String	True	Represents a URL to concatenate to the Microsoft Office Outlook Web App endpoint to read an item in Outlook Web App.
WebClientEditFormQueryString	String	True	Represents a URL to concatenate to the Outlook Web App endpoint to edit an item in Outlook Web App.
ConversationId	String	True	Identifies a specific conversation in the Exchange store.
UniqueBody	String	True	Represents an HTML fragment or plain-text which represents the unique body of this conversation.
UniqueBodyType	String	True	Describes how the unique item body is stored in the item (HTML or TEXT).
FileAs	String	False	Represents how a contact or distribution list is filed in the Contacts folder.
FileAsMapping	String	False	Defines how to construct what is displayed for a contact.
DisplayName	String	False	Defines the display name of a folder, contact, distribution list, delegate user, location, or rule.
GivenName	String	False	Contains the given name of a contact.
Initials	String	False	Represents the initials of a contact.
MiddleName	String	False	Represents the middle name of a contact.
Nickname	String	False	Represents the nickname of a contact.
CompleteName_Title	String	True	Represents the title of a contact.
CompleteName_FirstName	String	True	Represents the first name of a contact.
CompleteName_MiddleName	String	True	Represents the middle name of a contact.
CompleteName_LastName	String	True	Represents the last name of a contact.
CompleteName_Suffix	String	True	Represents the suffix of a contact.
CompleteName_Initials	String	True	Represents the initials of a contact.
CompleteName_FullName	String	True	Represents the full name of a contact.
CompleteName_Nickname	String	True	Represents the nickname of a contact.
CompleteName_YomiFirstName	String	True	Represents the name used in Japan for the searchable or phonetic spelling of a Japanese first name.
CompleteName_YomiLastName	String	True	Represents the name used in Japan for the searchable or phonetic spelling of a Japanese first name.
CompanyName	String	False	Represents the company name that is associated with a contact.
EmailAddress1	String	False	Represents a single email address for a contact.
EmailAddress2	String	False	Represents a single email address for a contact.
EmailAddress3	String	False	Represents a single email address for a contact.
BusinessAddress_Street	String	False	Represents the Business street address for a contact item.
BusinessAddress_City	String	False	Represents the Business city name for a contact item.
BusinessAddress_State	String	False	Represents the Business state of residence for a contact item.
BusinessAddress_Country	String	False	Represents the Business country or region for a contact item.
BusinessAddress_PostalCode	String	False	Represents the Business postal code for a contact item.
HomeAddress_Street	String	False	Represents the Home street address for a contact item.
HomeAddress_City	String	False	Represents the Home city name for a contact item.
HomeAddress_State	String	False	Represents the Home state of residence for a contact item.
HomeAddress_Country	String	False	Represents the Home country or region for a contact item.
HomeAddress_PostalCode	String	False	Represents the Home postal code for a contact item.
OtherAddress_Street	String	False	Represents the Other street address for a contact item.
OtherAddress_City	String	False	Represents the Other city name for a contact item.
OtherAddress_State	String	False	Represents the Other state of residence for a contact item.
OtherAddress_Country	String	False	Represents the Other country or region for a contact item.
OtherAddress_PostalCode	String	False	Represents the Other postal code for a contact item.
AssistantPhone	String	False	Represents the AssistantPhone number for a contact item.
BusinessFax	String	False	Represents the BusinessFax number for a contact item.
BusinessPhone	String	False	Represents the BusinessPhone number for a contact item.
BusinessPhone2	String	False	Represents the BusinessPhone2 number for a contact item.
Callback	String	False	Represents the Callback number for a contact item.
CarPhone	String	False	Represents the CarPhone number for a contact item.
CompanyMainPhone	String	False	Represents the CompanyMainPhone number for a contact item.
HomeFax	String	False	Represents the HomeFax number for a contact item.
HomePhone	String	False	Represents the HomePhone number for a contact item.
HomePhone2	String	False	Represents the HomePhone2 number for a contact item.
Isdn	String	False	Represents the Isdn number for a contact item.
MobilePhone	String	False	Represents the MobilePhone number for a contact item.
OtherFax	String	False	Represents the OtherFax number for a contact item.
OtherTelephone	String	False	Represents the OtherTelephone number for a contact item.
Pager	String	False	Represents the Pager number for a contact item.
PrimaryPhone	String	False	Represents the PrimaryPhone number for a contact item.
RadioPhone	String	False	Represents the RadioPhone number for a contact item.
Telex	String	False	Represents the Telex number for a contact item.
TtyTddPhone	String	False	Represents the TtyTddPhone number for a contact item.
AssistantName	String	False	Represents an assistant to a contact.
Birthday	Datetime	False	Represents the birth date of a contact.
BusinessHomePage	String	False	Represents the Home page (Web address) for the contact.
Children_1	String	False	Contains the name of the child of a contact.
Children_2	String	False	Contains the name of the child of a contact.
Children_3	String	False	Contains the name of the child of a contact.
Companies_1	String	False	Represents the name of a company associated with a contact.
Companies_2	String	False	Represents the name of a company associated with a contact.
Companies_3	String	False	Represents the name of a company associated with a contact.
ContactSource	String	False	Describes whether the contact is located in the Exchange store or Active Directory Domain Services.
Department	String	False	Represents the department of a contact.
Generation	String	False	Represents a generational abbreviation that follows the full name of a contact.
ImAddress1	String	False	Represents an instant messaging (IM) address for a contact.
ImAddress2	String	False	Represents an instant messaging (IM) address for a contact.
ImAddress3	String	False	Represents an instant messaging (IM) address for a contact.
JobTitle	String	False	Represents the job title of a contact.
Manager	String	False	Represents the manager of a contact.
Mileage	String	False	Represents the mileage for a contact item.
OfficeLocation	String	False	Represents the office location of a contact.
PostalAddressIndex	String	False	Represents the display type for the physical address of a contact.
Profession	String	False	Represents the profession of a contact.
SpouseName	String	False	Represents the name of the spouse or partner of the contact.
Surname	String	False	Represents the surname of a contact.
WeddingAnniversary	Datetime	False	Contains the wedding anniversary of a contact.
HasPicture	Boolean	False	Indicates whether the contact item has a file attachment that represents the picture of a contact.
PhoneticFullName	String	False	Contains the full name of a contact, including the first and last name, spelled phonetically.
PhoneticFirstName	String	False	Contains the first name of a contact, spelled phonetically.
PhoneticLastName	String	False	Contains the last name of a contact, spelled phonetically.
Alias	String	False	Contains the email alias of a contact.
Notes	String	False	Contains supplementary contact information.
Photo	String	False	Contains a value that encodes the photo of a contact.
UserSMIMECertificate	String	False	Contains a value that encodes the SMIME certificate of a contact.
MSExchangeCertificate	String	False	Contains a value that encodes the Microsoft Exchange certificate of a contact.
DirectoryId	String	False	Contains the directory Id of a contact.
ManagerMailbox	String	False	Contains SMTP information that identifies the mailbox of the manager of a contact.
DirectReports	String	False	Contains SMTP information that identifies the direct reports of a contact.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
ImpersonationUser	String	The Identifier of the user to impersonate.
ImpersonationType	String	The type of Identifier used for the impersonation user (PrincipalName, SID, PrimarySmtpAddress, SmtpAddress).

DeletedItems

Create, update, delete, and query Deleted Items.

テーブル固有の情報

Select Emails from DeletedItems Subfolders

When performing a SELECT operation on the DeletedItems table, the Cloud will not include the items in the subfolders under DeletedItems, but only the items contained within the DeletedItems folder. If you wish to retrieve the items under the DeletedItems subfolders, your will need to specify the ParentFolderId-s in the WHERE clause. You can get every DeletedItems subfolder Id by executing a filtered by ParentFolderName query to the Folders table. You can use the example query below, to retrieve the items within the DeletedItems subfolders:

SELECT * FROM DeletedItems WHERE ParentFolderId IN (SELECT FolderId FROM Folders WHERE ParentFolderName = 'DeletedItems' AND TotalCount > 0)

Update およびDelete

Cloud では、アイテムの更新および削除にはItemChangeKey が必要です。ただし、ItemChangeKey が不明な場合には、Cloud は自動的にExchange サーバーからこれを取得することができます。これはクエリ実行にかかる時間を増加させることに注意してください。

Columns


Name	Type	ReadOnly	Description
MimeContent	String	True	Contains the native Multipurpose Internet Mail Extensions (MIME) stream of an object that is represented in Base64 binary format.
ItemId [KEY]	String	True	Contains the unique identifier of an item in the Exchange store.
ItemChangeKey	String	True	Contains the unique change key of an item in the Exchange store.
ParentFolderId	String	False	Represents the unique identifier of the parent folder that contains the item or folder.
ParentFolderChangeKey	String	True	Represents the unique change key of the parent folder that contains the item or folder.
ItemClass	String	False	Represents the message class of an item.
Subject	String	False	Represents the subject for Exchange store items and response objects. The subject is limited to 255 characters.
Sensitivity	String	True	Indicates the sensitivity level of an item.
Body	String	False	Represents the actual body content of a message.
AttachmentIds	String	True	Contains a comma-separated list of the Ids of the attached files.
AttachmentNames	String	True	Contains a comma-separated list of the names of the attached files.
DateTimeReceived	Datetime	True	Represents the date and time that an item in a mailbox was received.
Size	Integer	True	Represents the size in bytes of an item. This property is read-only.
Categories	String	False	Represents a collection of strings that identify to which categories an item in the mailbox belongs.
Importance	String	False	Describes the importance of an item.
InReplyTo	String	False	Represents the identifier of the item to which this item is a reply.
IsSubmitted	Boolean	True	Indicates whether an item has been submitted to the Outbox default folder.
IsDraft	Boolean	True	Represents whether an item has not yet been sent.
IsFromMe	Boolean	True	Indicates whether a user sent an item to himself or herself.
IsResend	Boolean	True	Indicates whether the item had previously been sent.
IsUnmodified	Boolean	True	Indicates whether the item has been modified.
InternetMessageHeaders	String	True	Represents the collection of all Internet message headers that are contained within an item in a mailbox.
DateTimeSent	Datetime	True	Represents the date and time that an item in a mailbox was sent.
DateTimeCreated	Datetime	True	Represents the date and time that a given item in the mailbox was created.
ReminderDueBy	Datetime	False	Represents the date and time when the event occurs. This is used by the ReminderMinutesBeforeStart element to determine when the reminder is displayed.
ReminderIsSet	Boolean	False	Indicates whether a reminder has been set for an item in the Exchange store.
ReminderMinutesBeforeStart	Integer	False	Represents the number of minutes before an event occurs when a reminder is displayed.
DisplayCc	String	True	Represents the display string that is used for the contents of the To box. This is the concatenated string of all To recipient display names.
DisplayTo	String	True	Represents a property that is set to true if an item has at least one visible attachment. This property is read-only.
HasAttachments	Boolean	True	Indicates whether an item has attachments.
Culture	String	False	Represents the Culture of an item.
SenderName	String	False	Defines the name of the Sender mailbox user.
SenderEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the Sender mailbox user.
SenderRoutingType	String	False	Defines the routing that is used for the Sender mailbox. The default is SMTP.
ToRecipients_Name	String	False	Defines the name of the ToRecipient.
ToRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ToRecipient.
ToRecipients_ItemId	String	False	Defines the item identifier of a ToRecipient.
CcRecipients_Name	String	False	Defines the name of the CcRecipient.
CcRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the CcRecipient.
CcRecipients_ItemId	String	False	Defines the item identifier of a CcRecipient.
BccRecipients_Name	String	False	Defines the name of the BccRecipient.
BccRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the BccRecipient.
BccRecipients_ItemId	String	False	Defines the item identifier of a BccRecipient.
IsReadReceiptRequested	Boolean	False	Indicates whether the sender of an item requests a read receipt.
IsDeliveryReceiptRequested	Boolean	False	Indicates whether the sender of an item requests a delivery receipt.
ConversationIndex	String	False	Contains a binary Id that represents the thread to which this message belongs.
ConversationTopic	String	False	Represents the conversation topic.
FromName	String	False	Defines the name of the From mailbox user.
FromEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the From mailbox user.
FromRoutingType	String	False	Defines the routing that is used for the From mailbox. The default is SMTP.
InternetMessageId	String	False	Represents the Internet message identifier of an item.
IsRead	Boolean	False	Indicates whether a message has been read.
IsResponseRequested	Boolean	False	Indicates whether a response to an item is requested.
References	String	False	Represents the Usenet header that is used to associate replies with the original messages.
EffectiveRights_CreateAssociated	Boolean	True	Indicates whether a client can create an associated contents table.
EffectiveRights_CreateContents	Boolean	True	Indicates whether a client can create a contents table.
EffectiveRights_CreateHierarchy	Boolean	True	Indicates whether a client can create a hierarchy table.
EffectiveRights_Delete	Boolean	True	Indicates whether a client can delete a folder or item.
EffectiveRights_Modify	Boolean	True	Indicates whether a client can modify a folder or item.
EffectiveRights_Read	Boolean	True	Indicates whether a client can read a folder or item.
EffectiveRights_ViewPrivateItems	Boolean	True	Indicates whether a private item can be viewed.
ReceivedByName	String	False	Defines the name of the ReceivedBy mailbox user.
ReceivedByEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ReceivedBy mailbox user.
ReceivedByRoutingType	String	False	Defines the routing that is used for the ReceivedBy mailbox. The default is SMTP.
ReceivedRepresentingName	String	False	Defines the name of the ReceivedRepresenting mailbox user.
ReceivedRepresentingEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ReceivedRepresenting mailbox user.
ReceivedRepresentingRoutingType	String	False	Defines the routing that is used for the ReceivedRepresenting mailbox. The default is SMTP.
LastModifiedName	String	True	Contains the display name of the last user to modify an item.
LastModifiedTime	Datetime	True	Indicates when an item was last modified. This element is read-only.
IsAssociated	Boolean	False	Indicates whether the item is associated with a folder.
WebClientReadFormQueryString	String	True	Represents a URL to concatenate to the Microsoft Office Outlook Web App endpoint to read an item in Outlook Web App.
WebClientEditFormQueryString	String	True	Represents a URL to concatenate to the Outlook Web App endpoint to edit an item in Outlook Web App.
ConversationId	String	True	Identifies a specific conversation in the Exchange store.
ConversationChangeKey	String	True	Contains the change key of an item or conversation.
UniqueBody	String	True	Represents an HTML fragment or plain-text which represents the unique body of this conversation.
UniqueBodyType	String	True	Describes how the unique item body is stored in the item (HTML or TEXT).
ReminderMessageData_Text	String	False	Specifies the text of a reminder message.
ReminderMessageData_Location	String	False	Represents the location of a meeting, appointment, or persona.
ReminderMessageData_StartTime	Datetime	False	Specifies the starting time of the item that the reminder is for.
ReminderMessageData_EndTime	Datetime	False	Specifies the ending time of the item that the reminder is for.
ReminderMessageData_AssociatedCalendarId	String	True	Represents the calendar item that is associated with the ReminderMessageData.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
ImpersonationUser	String	The Identifier of the user to impersonate.
ImpersonationType	String	The type of Identifier used for the impersonation user (PrincipalName, SID, PrimarySmtpAddress, SmtpAddress).

Drafts

Create, update, delete, and query Drafts items.

テーブル固有の情報

Select Emails from Drafts Subfolders

When performing a SELECT operation on the Drafts table, the Cloud will not include the items in the subfolders under Drafts, but only the items contained within the Drafts folder. If you wish to retrieve the items under the Drafts subfolders, your will need to specify the ParentFolderId-s in the WHERE clause. You can get every Drafts subfolder Id by executing a filtered by ParentFolderName query to the Folders table. You can use the example query below, to retrieve the items within the Drafts subfolders:

SELECT * FROM Drafts WHERE ParentFolderId IN (SELECT FolderId FROM Folders WHERE ParentFolderName = 'Drafts' AND TotalCount > 0)

Update およびDelete

Cloud では、アイテムの更新および削除にはItemChangeKey が必要です。ただし、ItemChangeKey が不明な場合には、Cloud は自動的にExchange サーバーからこれを取得することができます。これはクエリ実行にかかる時間を増加させることに注意してください。

Columns


Name	Type	ReadOnly	Description
MimeContent	String	True	Contains the native Multipurpose Internet Mail Extensions (MIME) stream of an object that is represented in Base64 binary format.
ItemId [KEY]	String	True	Contains the unique identifier of an item in the Exchange store.
ItemChangeKey	String	True	Contains the unique change key of an item in the Exchange store.
ParentFolderId	String	False	Represents the unique identifier of the parent folder that contains the item or folder.
ParentFolderChangeKey	String	True	Represents the unique change key of the parent folder that contains the item or folder.
ItemClass	String	False	Represents the message class of an item.
Subject	String	False	Represents the subject for Exchange store items and response objects. The subject is limited to 255 characters.
Sensitivity	String	True	Indicates the sensitivity level of an item.
Body	String	False	Represents the actual body content of a message.
AttachmentIds	String	True	Contains a comma-separated list of the Ids of the attached files.
AttachmentNames	String	True	Contains a comma-separated list of the names of the attached files.
DateTimeReceived	Datetime	True	Represents the date and time that an item in a mailbox was received.
Size	Integer	True	Represents the size in bytes of an item. This property is read-only.
Categories	String	False	Represents a collection of strings that identify to which categories an item in the mailbox belongs.
Importance	String	False	Describes the importance of an item.
InReplyTo	String	False	Represents the identifier of the item to which this item is a reply.
IsSubmitted	Boolean	True	Indicates whether an item has been submitted to the Outbox default folder.
IsDraft	Boolean	True	Represents whether an item has not yet been sent.
IsFromMe	Boolean	True	Indicates whether a user sent an item to himself or herself.
IsResend	Boolean	True	Indicates whether the item had previously been sent.
IsUnmodified	Boolean	True	Indicates whether the item has been modified.
InternetMessageHeaders	String	True	Represents the collection of all Internet message headers that are contained within an item in a mailbox.
DateTimeSent	Datetime	True	Represents the date and time that an item in a mailbox was sent.
DateTimeCreated	Datetime	True	Represents the date and time that a given item in the mailbox was created.
ReminderDueBy	Datetime	False	Represents the date and time when the event occurs. This is used by the ReminderMinutesBeforeStart element to determine when the reminder is displayed.
ReminderIsSet	Boolean	False	Indicates whether a reminder has been set for an item in the Exchange store.
ReminderMinutesBeforeStart	Integer	False	Represents the number of minutes before an event occurs when a reminder is displayed.
DisplayCc	String	True	Represents the display string that is used for the contents of the Cc box. This is the concatenated string of all To recipient display names.
DisplayTo	String	True	Represents the display string that is used for the contents of the To box. This is the concatenated string of all To recipient display names.
HasAttachments	Boolean	True	Indicates whether an item has attachments.
Culture	String	False	Represents the Culture of an item.
SenderName	String	False	Defines the name of the Sender mailbox user.
SenderEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the Sender mailbox user.
SenderRoutingType	String	False	Defines the routing that is used for the Sender mailbox. The default is SMTP.
ToRecipients_Name	String	False	Defines the name of the ToRecipient.
ToRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ToRecipient.
ToRecipients_ItemId	String	False	Defines the item identifier of a ToRecipient.
CcRecipients_Name	String	False	Defines the name of the CcRecipient.
CcRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the CcRecipient.
CcRecipients_ItemId	String	False	Defines the item identifier of a CcRecipient.
BccRecipients_Name	String	False	Defines the name of the BccRecipient.
BccRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the BccRecipient.
BccRecipients_ItemId	String	False	Defines the item identifier of a BccRecipient.
IsReadReceiptRequested	Boolean	False	Indicates whether the sender of an item requests a read receipt.
IsDeliveryReceiptRequested	Boolean	False	Indicates whether the sender of an item requests a delivery receipt.
ConversationIndex	String	False	Contains a binary Id that represents the thread to which this message belongs.
ConversationTopic	String	False	Represents the conversation topic.
FromName	String	False	Defines the name of the From mailbox user.
FromEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the From mailbox user.
FromRoutingType	String	False	Defines the routing that is used for the From mailbox. The default is SMTP.
InternetMessageId	String	False	Represents the Internet message identifier of an item.
IsRead	Boolean	False	Indicates whether a message has been read.
IsResponseRequested	Boolean	False	Indicates whether a response to an item is requested.
References	String	False	Represents the Usenet header that is used to associate replies with the original messages.
EffectiveRights_CreateAssociated	Boolean	True	Indicates whether a client can create an associated contents table.
EffectiveRights_CreateContents	Boolean	True	Indicates whether a client can create a contents table.
EffectiveRights_CreateHierarchy	Boolean	True	Indicates whether a client can create a hierarchy table.
EffectiveRights_Delete	Boolean	True	Indicates whether a client can delete a folder or item.
EffectiveRights_Modify	Boolean	True	Indicates whether a client can modify a folder or item.
EffectiveRights_Read	Boolean	True	Indicates whether a client can read a folder or item.
EffectiveRights_ViewPrivateItems	Boolean	True	Indicates whether a private item can be viewed.
ReceivedByName	String	False	Defines the name of the ReceivedBy mailbox user.
ReceivedByEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ReceivedBy mailbox user.
ReceivedByRoutingType	String	False	Defines the routing that is used for the ReceivedBy mailbox. The default is SMTP.
ReceivedRepresentingName	String	False	Defines the name of the ReceivedRepresenting mailbox user.
ReceivedRepresentingEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ReceivedRepresenting mailbox user.
ReceivedRepresentingRoutingType	String	False	Defines the routing that is used for the ReceivedRepresenting mailbox. The default is SMTP.
LastModifiedName	String	True	Contains the display name of the last user to modify an item.
LastModifiedTime	Datetime	True	Indicates when an item was last modified. This element is read-only.
IsAssociated	Boolean	False	Indicates whether the item is associated with a folder.
WebClientReadFormQueryString	String	True	Represents a URL to concatenate to the Microsoft Office Outlook Web App endpoint to read an item in Outlook Web App.
WebClientEditFormQueryString	String	True	Represents a URL to concatenate to the Outlook Web App endpoint to edit an item in Outlook Web App.
ConversationId	String	True	Identifies a specific conversation in the Exchange store.
ConversationChangeKey	String	True	Contains the change key of an item or conversation.
UniqueBody	String	True	Represents an HTML fragment or plain-text which represents the unique body of this conversation.
UniqueBodyType	String	True	Describes how the unique item body is stored in the item (HTML or TEXT).
ReminderMessageData_Text	String	False	Specifies the text of a reminder message.
ReminderMessageData_Location	String	False	Represents the location of a meeting, appointment, or persona.
ReminderMessageData_StartTime	Datetime	False	Specifies the starting time of the item that the reminder is for.
ReminderMessageData_EndTime	Datetime	False	Specifies the ending time of the item that the reminder is for.
ReminderMessageData_AssociatedCalendarId	String	True	Represents the calendar item that is associated with the ReminderMessageData.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
ImpersonationUser	String	The Identifier of the user to impersonate.
ImpersonationType	String	The type of Identifier used for the impersonation user (PrincipalName, SID, PrimarySmtpAddress, SmtpAddress).

Folders

Create, update, delete, and query subfolders for a given folder.

テーブル固有の情報

Update およびDelete

Cloud では、アイテムの更新もしくは削除にはFolderChangeKey が必要です。ただし、FolderChangeKey が不明な場合には、Cloud は自動的にExchange サーバーからこれを取得することができます。これはクエリ実行にかかる時間を増加させることに注意してください。

Columns


Name	Type	ReadOnly	Description
FolderId [KEY]	String	True	Contains the unique identifier of an folder in the Exchange store.
FolderChangeKey	String	True	Contains the unique change key of an folder in the Exchange store.
ParentFolderId	String	False	Represents the unique identifier of the parent folder that contains the item or folder.
ParentFolderChangeKey	String	True	Represents the unique change key of the parent folder that contains the item or folder.
FolderClass	String	False	Represents the folder class for a given folder.
DisplayName	String	False	Contains the display name of a folder.
TotalCount	Integer	True	Represents the total count of items within a given folder.
ChildFolderCount	Integer	True	Represents the number of child folders that are contained within a folder.
CanDelete	Boolean	True	Indicates whether a managed folder can be deleted by a customer.
CanRenameOrMove	Boolean	True	Indicates whether a given managed folder can be renamed or moved by the customer.
MustDisplayComment	Boolean	True	Indicates whether the managed folder comment must be displayed.
HasQuota	Boolean	True	Indicates whether the managed folder has a quota.
IsManagedFoldersRoot	Boolean	True	Indicates whether the managed folder is the root for all managed folders.
ManagedFolderId	String	True	Contains the folder Id of the managed folder.
Comment	String	True	Contains the comment that is associated with a managed folder.
StorageQuota	Integer	True	Describes the storage quota for the managed folder.
FolderSize	Integer	True	Describes the total size of all the contents of a managed folder.
HomePage	String	True	Specifies the URL that will be the default home page for the managed folder.
UnreadCount	Integer	True	Represents the count of unread items within a given folder.
EffectiveRights_CreateAssociated	Boolean	True	Indicates whether a client can create an associated contents table.
EffectiveRights_CreateContents	Boolean	True	Indicates whether a client can create a contents table.
EffectiveRights_CreateHierarchy	Boolean	True	Indicates whether a client can create a hierarchy table.
EffectiveRights_Delete	Boolean	True	Indicates whether a client can delete a folder or item.
EffectiveRights_Modify	Boolean	True	Indicates whether a client can modify a folder or item.
EffectiveRights_Read	Boolean	True	Indicates whether a client can read a folder or item.
EffectiveRights_ViewPrivateItems	Boolean	True	Indicates whether a private item can be viewed.
SharingEffectiveRights	String	False	Indicates the permissions that the user has for the contact data that is being shared.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
ImpersonationUser	String	The Identifier of the user to impersonate.
ImpersonationType	String	The type of Identifier used for the impersonation user (PrincipalName, SID, PrimarySmtpAddress, SmtpAddress).
ParentFolderName	String	Represents the distinguished folder Id of the parent folder.

Inbox

Create, update, delete, and query Inbox items.

テーブル固有の情報

Select Emails from Inbox Subfolders

When performing a SELECT operation on the Inbox table, the Cloud will not include the items in the subfolders under Inbox, but only the items contained within the Inbox folder. If you wish to retrieve the items under the Inbox subfolders, your will need to specify the ParentFolderId-s in the WHERE clause. You can get every Inbox subfolder Id by executing a filtered by ParentFolderName query to the Folders table. You can use the example query below, to retrieve the items within the Inbox subfolders:

SELECT * FROM Inbox WHERE ParentFolderId IN (SELECT FolderId FROM Folders WHERE ParentFolderName = 'Inbox' AND TotalCount > 0)

Update およびDelete

Cloud では、アイテムの更新および削除にはItemChangeKey が必要です。ただし、ItemChangeKey が不明な場合には、Cloud は自動的にExchange サーバーからこれを取得することができます。これはクエリ実行にかかる時間を増加させることに注意してください。

Columns


Name	Type	ReadOnly	Description
MimeContent	String	True	Contains the native Multipurpose Internet Mail Extensions (MIME) stream of an object that is represented in Base64 binary format.
ItemId [KEY]	String	True	Contains the unique identifier of an item in the Exchange store.
ItemChangeKey	String	True	Contains the unique change key of an item in the Exchange store.
ParentFolderId	String	False	Represents the unique identifier of the parent folder that contains the item or folder.
ParentFolderChangeKey	String	True	Represents the unique change key of the parent folder that contains the item or folder.
ItemClass	String	False	Represents the message class of an item.
Subject	String	False	Represents the subject for Exchange store items and response objects. The subject is limited to 255 characters.
Sensitivity	String	True	Indicates the sensitivity level of an item.
Body	String	False	Represents the actual body content of a message.
AttachmentId#	String	True	Contains a comma-separated list of the Ids of the attached files.
AttachmentName#	String	True	Contains a comma-separated list of the names of the attached files.
DateTimeReceived	Datetime	True	Represents the date and time that an item in a mailbox was received.
Size	Integer	True	Represents the size in bytes of an item. This property is read-only.
Categories	String	False	Represents a collection of strings that identify to which categories an item in the mailbox belongs.
Importance	String	False	Describes the importance of an item.
InReplyTo	String	False	Represents the identifier of the item to which this item is a reply.
IsSubmitted	Boolean	True	Indicates whether an item has been submitted to the Outbox default folder.
IsDraft	Boolean	True	Represents whether an item has not yet been sent.
IsFromMe	Boolean	True	Indicates whether a user sent an item to himself or herself.
IsResend	Boolean	True	Indicates whether the item had previously been sent.
IsUnmodified	Boolean	True	Indicates whether the item has been modified.
InternetMessageHeaders	String	True	Represents the collection of all Internet message headers that are contained within an item in a mailbox.
DateTimeSent	Datetime	True	Represents the date and time that an item in a mailbox was sent.
DateTimeCreated	Datetime	True	Represents the date and time that a given item in the mailbox was created.
ReminderDueBy	Datetime	False	Represents the date and time when the event occurs. This is used by the ReminderMinutesBeforeStart element to determine when the reminder is displayed.
ReminderIsSet	Boolean	False	Indicates whether a reminder has been set for an item in the Exchange store.
ReminderMinutesBeforeStart	Integer	False	Represents the number of minutes before an event occurs when a reminder is displayed.
DisplayCc	String	True	Represents the display string that is used for the contents of the To box. This is the concatenated string of all To recipient display names.
DisplayTo	String	True	Represents a property that is set to true if an item has at least one visible attachment. This property is read-only.
HasAttachments	Boolean	True	Indicates whether an item has attachments.
Culture	String	False	Represents the Culture of an item.
SenderName	String	False	Defines the name of the Sender mailbox user.
SenderEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the Sender mailbox user.
SenderRoutingType	String	False	Defines the routing that is used for the Sender mailbox. The default is SMTP.
ToRecipients_Name	String	False	Defines the name of the ToRecipient.
ToRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ToRecipient.
ToRecipients_ItemId	String	False	Defines the item identifier of a ToRecipient.
CcRecipients_Name	String	False	Defines the name of the CcRecipient.
CcRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the CcRecipient.
CcRecipients_ItemId	String	False	Defines the item identifier of a CcRecipient.
BccRecipients_Name	String	False	Defines the name of the BccRecipient.
BccRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the BccRecipient.
BccRecipients_ItemId	String	False	Defines the item identifier of a BccRecipient.
IsReadReceiptRequested	Boolean	False	Indicates whether the sender of an item requests a read receipt.
IsDeliveryReceiptRequested	Boolean	False	Indicates whether the sender of an item requests a delivery receipt.
ConversationIndex	String	False	Contains a binary Id that represents the thread to which this message belongs.
ConversationTopic	String	False	Represents the conversation topic.
FromName	String	False	Defines the name of the From mailbox user.
FromEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the From mailbox user.
FromRoutingType	String	False	Defines the routing that is used for the From mailbox. The default is SMTP.
InternetMessageId	String	False	Represents the Internet message identifier of an item.
IsRead	Boolean	False	Indicates whether a message has been read.
IsResponseRequested	Boolean	False	Indicates whether a response to an item is requested.
References	String	False	Represents the Usenet header that is used to associate replies with the original messages.
EffectiveRights_CreateAssociated	Boolean	True	Indicates whether a client can create an associated contents table.
EffectiveRights_CreateContents	Boolean	True	Indicates whether a client can create a contents table.
EffectiveRights_CreateHierarchy	Boolean	True	Indicates whether a client can create a hierarchy table.
EffectiveRights_Delete	Boolean	True	Indicates whether a client can delete a folder or item.
EffectiveRights_Modify	Boolean	True	Indicates whether a client can modify a folder or item.
EffectiveRights_Read	Boolean	True	Indicates whether a client can read a folder or item.
EffectiveRights_ViewPrivateItems	Boolean	True	Indicates whether a private item can be viewed.
ReceivedByName	String	False	Defines the name of the ReceivedBy mailbox user.
ReceivedByEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ReceivedBy mailbox user.
ReceivedByRoutingType	String	False	Defines the routing that is used for the ReceivedBy mailbox. The default is SMTP.
ReceivedRepresentingName	String	False	Defines the name of the ReceivedRepresenting mailbox user.
ReceivedRepresentingEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ReceivedRepresenting mailbox user.
ReceivedRepresentingRoutingType	String	False	Defines the routing that is used for the ReceivedRepresenting mailbox. The default is SMTP.
LastModifiedName	String	True	Contains the display name of the last user to modify an item.
LastModifiedTime	Datetime	True	Indicates when an item was last modified. This element is read-only.
IsAssociated	Boolean	False	Indicates whether the item is associated with a folder.
WebClientReadFormQueryString	String	True	Represents a URL to concatenate to the Microsoft Office Outlook Web App endpoint to read an item in Outlook Web App.
WebClientEditFormQueryString	String	True	Represents a URL to concatenate to the Outlook Web App endpoint to edit an item in Outlook Web App.
ConversationId	String	True	Identifies a specific conversation in the Exchange store.
ConversationChangeKey	String	True	Contains the change key of an item or conversation.
UniqueBody	String	True	Represents an HTML fragment or plain-text which represents the unique body of this conversation.
UniqueBodyType	String	True	Describes how the unique item body is stored in the item (HTML or TEXT).
ReminderMessageData_Text	String	False	Specifies the text of a reminder message.
ReminderMessageData_Location	String	False	Represents the location of a meeting, appointment, or persona.
ReminderMessageData_StartTime	Datetime	False	Specifies the starting time of the item that the reminder is for.
ReminderMessageData_EndTime	Datetime	False	Specifies the ending time of the item that the reminder is for.
ReminderMessageData_AssociatedCalendarId	String	True	Represents the calendar item that is associated with the ReminderMessageData.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
ImpersonationUser	String	The Identifier of the user to impersonate.
ImpersonationType	String	The type of Identifier used for the impersonation user (PrincipalName, SID, PrimarySmtpAddress, SmtpAddress).
SharedMailboxEmail	String	The email of a shared mailbox. Use this to retrieve the inbox items of a shared mailbox.

JunkEmail

Create, update, delete, and query Junk Email items.

Columns


Name	Type	ReadOnly	Description
MimeContent	String	True	Contains the native Multipurpose Internet Mail Extensions (MIME) stream of an object that is represented in Base64 binary format.
ItemId [KEY]	String	True	Contains the unique identifier of an item in the Exchange store.
ItemChangeKey	String	True	Contains the unique change key of an item in the Exchange store.
ParentFolderId	String	False	Represents the unique identifier of the parent folder that contains the item or folder.
ParentFolderChangeKey	String	True	Represents the unique change key of the parent folder that contains the item or folder.
ItemClass	String	False	Represents the message class of an item.
Subject	String	False	Represents the subject for Exchange store items and response objects. The subject is limited to 255 characters.
Sensitivity	String	True	Indicates the sensitivity level of an item.
Body	String	False	Represents the actual body content of a message.
AttachmentIds	String	True	Contains a comma-separated list of the Ids of the attached files.
AttachmentNames	String	True	Contains a comma-separated list of the names of the attached files.
DateTimeReceived	Datetime	True	Represents the date and time that an item in a mailbox was received.
Size	Integer	True	Represents the size in bytes of an item. This property is read-only.
Categories	String	False	Represents a collection of strings that identify to which categories an item in the mailbox belongs.
Importance	String	False	Describes the importance of an item.
InReplyTo	String	False	Represents the identifier of the item to which this item is a reply.
IsSubmitted	Boolean	True	Indicates whether an item has been submitted to the Outbox default folder.
IsDraft	Boolean	True	Represents whether an item has not yet been sent.
IsFromMe	Boolean	True	Indicates whether a user sent an item to himself or herself.
IsResend	Boolean	True	Indicates whether the item had previously been sent.
IsUnmodified	Boolean	True	Indicates whether the item has been modified.
InternetMessageHeaders	String	True	Represents the collection of all Internet message headers that are contained within an item in a mailbox.
DateTimeSent	Datetime	True	Represents the date and time that an item in a mailbox was sent.
DateTimeCreated	Datetime	True	Represents the date and time that a given item in the mailbox was created.
ReminderDueBy	Datetime	False	Represents the date and time when the event occurs. This is used by the ReminderMinutesBeforeStart element to determine when the reminder is displayed.
ReminderIsSet	Boolean	False	Indicates whether a reminder has been set for an item in the Exchange store.
ReminderMinutesBeforeStart	Integer	False	Represents the number of minutes before an event occurs when a reminder is displayed.
DisplayCc	String	True	Represents the display string that is used for the contents of the To box. This is the concatenated string of all To recipient display names.
DisplayTo	String	True	Represents a property that is set to true if an item has at least one visible attachment. This property is read-only.
HasAttachments	Boolean	True	Indicates whether an item has attachments.
Culture	String	False	Represents the Culture of an item.
SenderName	String	False	Defines the name of the Sender mailbox user.
SenderEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the Sender mailbox user.
SenderRoutingType	String	False	Defines the routing that is used for the Sender mailbox. The default is SMTP.
ToRecipients_Name	String	False	Defines the name of the ToRecipient.
ToRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ToRecipient.
ToRecipients_ItemId	String	False	Defines the item identifier of a ToRecipient.
CcRecipients_Name	String	False	Defines the name of the CcRecipient.
CcRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the CcRecipient.
CcRecipients_ItemId	String	False	Defines the item identifier of a CcRecipient.
BccRecipients_Name	String	False	Defines the name of the BccRecipient.
BccRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the BccRecipient.
BccRecipients_ItemId	String	False	Defines the item identifier of a BccRecipient.
IsReadReceiptRequested	Boolean	False	Indicates whether the sender of an item requests a read receipt.
IsDeliveryReceiptRequested	Boolean	False	Indicates whether the sender of an item requests a delivery receipt.
ConversationIndex	String	False	Contains a binary Id that represents the thread to which this message belongs.
ConversationTopic	String	False	Represents the conversation topic.
FromName	String	False	Defines the name of the From mailbox user.
FromEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the From mailbox user.
FromRoutingType	String	False	Defines the routing that is used for the From mailbox. The default is SMTP.
InternetMessageId	String	False	Represents the Internet message identifier of an item.
IsRead	Boolean	False	Indicates whether a message has been read.
IsResponseRequested	Boolean	False	Indicates whether a response to an item is requested.
References	String	False	Represents the Usenet header that is used to associate replies with the original messages.
EffectiveRights_CreateAssociated	Boolean	True	Indicates whether a client can create an associated contents table.
EffectiveRights_CreateContents	Boolean	True	Indicates whether a client can create a contents table.
EffectiveRights_CreateHierarchy	Boolean	True	Indicates whether a client can create a hierarchy table.
EffectiveRights_Delete	Boolean	True	Indicates whether a client can delete a folder or item.
EffectiveRights_Modify	Boolean	True	Indicates whether a client can modify a folder or item.
EffectiveRights_Read	Boolean	True	Indicates whether a client can read a folder or item.
EffectiveRights_ViewPrivateItems	Boolean	True	Indicates whether a private item can be viewed.
ReceivedByName	String	False	Defines the name of the ReceivedBy mailbox user.
ReceivedByEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ReceivedBy mailbox user.
ReceivedByRoutingType	String	False	Defines the routing that is used for the ReceivedBy mailbox. The default is SMTP.
ReceivedRepresentingName	String	False	Defines the name of the ReceivedRepresenting mailbox user.
ReceivedRepresentingEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ReceivedRepresenting mailbox user.
ReceivedRepresentingRoutingType	String	False	Defines the routing that is used for the ReceivedRepresenting mailbox. The default is SMTP.
LastModifiedName	String	True	Contains the display name of the last user to modify an item.
LastModifiedTime	Datetime	True	Indicates when an item was last modified. This element is read-only.
IsAssociated	Boolean	False	Indicates whether the item is associated with a folder.
WebClientReadFormQueryString	String	True	Represents a URL to concatenate to the Microsoft Office Outlook Web App endpoint to read an item in Outlook Web App.
WebClientEditFormQueryString	String	True	Represents a URL to concatenate to the Outlook Web App endpoint to edit an item in Outlook Web App.
ConversationId	String	True	Identifies a specific conversation in the Exchange store.
ConversationChangeKey	String	True	Contains the change key of an item or conversation.
UniqueBody	String	True	Represents an HTML fragment or plain-text which represents the unique body of this conversation.
UniqueBodyType	String	True	Describes how the unique item body is stored in the item (HTML or TEXT).
ReminderMessageData_Text	String	False	Specifies the text of a reminder message.
ReminderMessageData_Location	String	False	Represents the location of a meeting, appointment, or persona.
ReminderMessageData_StartTime	Datetime	False	Specifies the starting time of the item that the reminder is for.
ReminderMessageData_EndTime	Datetime	False	Specifies the ending time of the item that the reminder is for.
ReminderMessageData_AssociatedCalendarId	String	True	Represents the calendar item that is associated with the ReminderMessageData.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
ImpersonationUser	String	The Identifier of the user to impersonate.
ImpersonationType	String	The type of Identifier used for the impersonation user (PrincipalName, SID, PrimarySmtpAddress, SmtpAddress).

Outbox

Create, update, delete, and query Outbox items.

テーブル固有の情報

Select Emails from Outbox Subfolders

When performing a SELECT operation on the Outbox table, the Cloud will not include the items in the subfolders under Outbox, but only the items contained within the Outbox folder. If you wish to retrieve the items under the Outbox subfolders, your will need to specify the ParentFolderId-s in the WHERE clause. You can get every Outbox subfolder Id by executing a filtered by ParentFolderName query to the Folders table. You can use the example query below, to retrieve the items within the Outbox subfolders:

SELECT * FROM Outbox WHERE ParentFolderId IN (SELECT FolderId FROM Folders WHERE ParentFolderName = 'Outbox' AND TotalCount > 0)

Update およびDelete

Cloud では、アイテムの更新および削除にはItemChangeKey が必要です。ただし、ItemChangeKey が不明な場合には、Cloud は自動的にExchange サーバーからこれを取得することができます。これはクエリ実行にかかる時間を増加させることに注意してください。

Columns


Name	Type	ReadOnly	Description
MimeContent	String	True	Contains the native Multipurpose Internet Mail Extensions (MIME) stream of an object that is represented in Base64 binary format.
ItemId [KEY]	String	True	Contains the unique identifier of an item in the Exchange store.
ItemChangeKey	String	True	Contains the unique change key of an item in the Exchange store.
ParentFolderId	String	False	Represents the unique identifier of the parent folder that contains the item or folder.
ParentFolderChangeKey	String	True	Represents the unique change key of the parent folder that contains the item or folder.
ItemClass	String	False	Represents the message class of an item.
Subject	String	False	Represents the subject for Exchange store items and response objects. The subject is limited to 255 characters.
Sensitivity	String	True	Indicates the sensitivity level of an item.
Body	String	False	Represents the actual body content of a message.
AttachmentIds	String	True	Contains a comma-separated list of the Ids of the attached files.
AttachmentNames	String	True	Contains a comma-separated list of the names of the attached files.
DateTimeReceived	Datetime	True	Represents the date and time that an item in a mailbox was received.
Size	Integer	True	Represents the size in bytes of an item. This property is read-only.
Categories	String	False	Represents a collection of strings that identify to which categories an item in the mailbox belongs.
Importance	String	False	Describes the importance of an item.
InReplyTo	String	False	Represents the identifier of the item to which this item is a reply.
IsSubmitted	Boolean	True	Indicates whether an item has been submitted to the Outbox default folder.
IsDraft	Boolean	True	Represents whether an item has not yet been sent.
IsFromMe	Boolean	True	Indicates whether a user sent an item to himself or herself.
IsResend	Boolean	True	Indicates whether the item had previously been sent.
IsUnmodified	Boolean	True	Indicates whether the item has been modified.
InternetMessageHeaders	String	True	Represents the collection of all Internet message headers that are contained within an item in a mailbox.
DateTimeSent	Datetime	True	Represents the date and time that an item in a mailbox was sent.
DateTimeCreated	Datetime	True	Represents the date and time that a given item in the mailbox was created.
ReminderDueBy	Datetime	False	Represents the date and time when the event occurs. This is used by the ReminderMinutesBeforeStart element to determine when the reminder is displayed.
ReminderIsSet	Boolean	False	Indicates whether a reminder has been set for an item in the Exchange store.
ReminderMinutesBeforeStart	Integer	False	Represents the number of minutes before an event occurs when a reminder is displayed.
DisplayCc	String	True	Represents the display string that is used for the contents of the To box. This is the concatenated string of all To recipient display names.
DisplayTo	String	True	Represents a property that is set to true if an item has at least one visible attachment. This property is read-only.
HasAttachments	Boolean	True	Indicates whether an item has attachments.
Culture	String	False	Represents the Culture of an item.
SenderName	String	False	Defines the name of the Sender mailbox user.
SenderEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the Sender mailbox user.
SenderRoutingType	String	False	Defines the routing that is used for the Sender mailbox. The default is SMTP.
ToRecipients_Name	String	False	Defines the name of the ToRecipient.
ToRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ToRecipient.
ToRecipients_ItemId	String	False	Defines the item identifier of a ToRecipient.
CcRecipients_Name	String	False	Defines the name of the CcRecipient.
CcRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the CcRecipient.
CcRecipients_ItemId	String	False	Defines the item identifier of a CcRecipient.
BccRecipients_Name	String	False	Defines the name of the BccRecipient.
BccRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the BccRecipient.
BccRecipients_ItemId	String	False	Defines the item identifier of a BccRecipient.
IsReadReceiptRequested	Boolean	False	Indicates whether the sender of an item requests a read receipt.
IsDeliveryReceiptRequested	Boolean	False	Indicates whether the sender of an item requests a delivery receipt.
ConversationIndex	String	False	Contains a binary Id that represents the thread to which this message belongs.
ConversationTopic	String	False	Represents the conversation topic.
FromName	String	False	Defines the name of the From mailbox user.
FromEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the From mailbox user.
FromRoutingType	String	False	Defines the routing that is used for the From mailbox. The default is SMTP.
InternetMessageId	String	False	Represents the Internet message identifier of an item.
IsRead	Boolean	False	Indicates whether a message has been read.
IsResponseRequested	Boolean	False	Indicates whether a response to an item is requested.
References	String	False	Represents the Usenet header that is used to associate replies with the original messages.
EffectiveRights_CreateAssociated	Boolean	True	Indicates whether a client can create an associated contents table.
EffectiveRights_CreateContents	Boolean	True	Indicates whether a client can create a contents table.
EffectiveRights_CreateHierarchy	Boolean	True	Indicates whether a client can create a hierarchy table.
EffectiveRights_Delete	Boolean	True	Indicates whether a client can delete a folder or item.
EffectiveRights_Modify	Boolean	True	Indicates whether a client can modify a folder or item.
EffectiveRights_Read	Boolean	True	Indicates whether a client can read a folder or item.
EffectiveRights_ViewPrivateItems	Boolean	True	Indicates whether a private item can be viewed.
ReceivedByName	String	False	Defines the name of the ReceivedBy mailbox user.
ReceivedByEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ReceivedBy mailbox user.
ReceivedByRoutingType	String	False	Defines the routing that is used for the ReceivedBy mailbox. The default is SMTP.
ReceivedRepresentingName	String	False	Defines the name of the ReceivedRepresenting mailbox user.
ReceivedRepresentingEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ReceivedRepresenting mailbox user.
ReceivedRepresentingRoutingType	String	False	Defines the routing that is used for the ReceivedRepresenting mailbox. The default is SMTP.
LastModifiedName	String	True	Contains the display name of the last user to modify an item.
LastModifiedTime	Datetime	True	Indicates when an item was last modified. This element is read-only.
IsAssociated	Boolean	False	Indicates whether the item is associated with a folder.
WebClientReadFormQueryString	String	True	Represents a URL to concatenate to the Microsoft Office Outlook Web App endpoint to read an item in Outlook Web App.
WebClientEditFormQueryString	String	True	Represents a URL to concatenate to the Outlook Web App endpoint to edit an item in Outlook Web App.
ConversationId	String	True	Identifies a specific conversation in the Exchange store.
ConversationChangeKey	String	True	Contains the change key of an item or conversation.
UniqueBody	String	True	Represents an HTML fragment or plain-text which represents the unique body of this conversation.
UniqueBodyType	String	True	Describes how the unique item body is stored in the item (HTML or TEXT).
ReminderMessageData_Text	String	False	Specifies the text of a reminder message.
ReminderMessageData_Location	String	False	Represents the location of a meeting, appointment, or persona.
ReminderMessageData_StartTime	Datetime	False	Specifies the starting time of the item that the reminder is for.
ReminderMessageData_EndTime	Datetime	False	Specifies the ending time of the item that the reminder is for.
ReminderMessageData_AssociatedCalendarId	String	True	Represents the calendar item that is associated with the ReminderMessageData.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
ImpersonationUser	String	The Identifier of the user to impersonate.
ImpersonationType	String	The type of Identifier used for the impersonation user (PrincipalName, SID, PrimarySmtpAddress, SmtpAddress).

SentItems

Create, update, delete, and query Sent Items.

テーブル固有の情報

Select Emails from SentItems Subfolders

When performing a SELECT operation on the SentItems table, the Cloud will not include the items in the subfolders under SentItems, but only the items contained within the SentItems folder. If you wish to retrieve the items under the SentItems subfolders, your will need to specify the ParentFolderId-s in the WHERE clause. You can get every SentItems subfolder Id by executing a filtered by ParentFolderName query to the Folders table. You can use the example query below, to retrieve the items within the SentItems subfolders:

SELECT * FROM SentItems WHERE ParentFolderId IN (SELECT FolderId FROM Folders WHERE ParentFolderName = 'SentItems' AND TotalCount > 0)

Update およびDelete

Cloud では、アイテムの更新および削除にはItemChangeKey が必要です。ただし、ItemChangeKey が不明な場合には、Cloud は自動的にExchange サーバーからこれを取得することができます。これはクエリ実行にかかる時間を増加させることに注意してください。

Columns


Name	Type	ReadOnly	Description
MimeContent	String	True	Contains the native Multipurpose Internet Mail Extensions (MIME) stream of an object that is represented in Base64 binary format.
ItemId [KEY]	String	True	Contains the unique identifier of an item in the Exchange store.
ItemChangeKey	String	True	Contains the unique change key of an item in the Exchange store.
ParentFolderId	String	False	Represents the unique identifier of the parent folder that contains the item or folder.
ParentFolderChangeKey	String	True	Represents the unique change key of the parent folder that contains the item or folder.
ItemClass	String	False	Represents the message class of an item.
Subject	String	False	Represents the subject for Exchange store items and response objects. The subject is limited to 255 characters.
Sensitivity	String	True	Indicates the sensitivity level of an item.
Body	String	False	Represents the actual body content of a message.
AttachmentIds	String	True	Contains a comma-separated list of the Ids of the attached files.
AttachmentNames	String	True	Contains a comma-separated list of the names of the attached files.
DateTimeReceived	Datetime	True	Represents the date and time that an item in a mailbox was received.
Size	Integer	True	Represents the size in bytes of an item. This property is read-only.
Categories	String	False	Represents a collection of strings that identify to which categories an item in the mailbox belongs.
Importance	String	False	Describes the importance of an item.
InReplyTo	String	False	Represents the identifier of the item to which this item is a reply.
IsSubmitted	Boolean	True	Indicates whether an item has been submitted to the Outbox default folder.
IsDraft	Boolean	True	Represents whether an item has not yet been sent.
IsFromMe	Boolean	True	Indicates whether a user sent an item to himself or herself.
IsResend	Boolean	True	Indicates whether the item had previously been sent.
IsUnmodified	Boolean	True	Indicates whether the item has been modified.
InternetMessageHeaders	String	True	Represents the collection of all Internet message headers that are contained within an item in a mailbox.
DateTimeSent	Datetime	True	Represents the date and time that an item in a mailbox was sent.
DateTimeCreated	Datetime	True	Represents the date and time that a given item in the mailbox was created.
ReminderDueBy	Datetime	False	Represents the date and time when the event occurs. This is used by the ReminderMinutesBeforeStart element to determine when the reminder is displayed.
ReminderIsSet	Boolean	False	Indicates whether a reminder has been set for an item in the Exchange store.
ReminderMinutesBeforeStart	Integer	False	Represents the number of minutes before an event occurs when a reminder is displayed.
DisplayCc	String	True	Represents the display string that is used for the contents of the To box. This is the concatenated string of all To recipient display names.
DisplayTo	String	True	Represents a property that is set to true if an item has at least one visible attachment. This property is read-only.
HasAttachments	Boolean	True	Indicates whether an item has attachments.
Culture	String	False	Represents the Culture of an item.
SenderName	String	False	Defines the name of the Sender mailbox user.
SenderEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the Sender mailbox user.
SenderRoutingType	String	False	Defines the routing that is used for the Sender mailbox. The default is SMTP.
ToRecipients_Name	String	False	Defines the name of the ToRecipient.
ToRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ToRecipient.
ToRecipients_ItemId	String	False	Defines the item identifier of a ToRecipient.
CcRecipients_Name	String	False	Defines the name of the CcRecipient.
CcRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the CcRecipient.
CcRecipients_ItemId	String	False	Defines the item identifier of a CcRecipient.
BccRecipients_Name	String	False	Defines the name of the BccRecipient.
BccRecipients_EmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the BccRecipient.
BccRecipients_ItemId	String	False	Defines the item identifier of a BccRecipient.
IsReadReceiptRequested	Boolean	False	Indicates whether the sender of an item requests a read receipt.
IsDeliveryReceiptRequested	Boolean	False	Indicates whether the sender of an item requests a delivery receipt.
ConversationIndex	String	False	Contains a binary Id that represents the thread to which this message belongs.
ConversationTopic	String	False	Represents the conversation topic.
FromName	String	False	Defines the name of the From mailbox user.
FromEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the From mailbox user.
FromRoutingType	String	False	Defines the routing that is used for the From mailbox. The default is SMTP.
InternetMessageId	String	False	Represents the Internet message identifier of an item.
IsRead	Boolean	False	Indicates whether a message has been read.
IsResponseRequested	Boolean	False	Indicates whether a response to an item is requested.
References	String	False	Represents the Usenet header that is used to associate replies with the original messages.
EffectiveRights_CreateAssociated	Boolean	True	Indicates whether a client can create an associated contents table.
EffectiveRights_CreateContents	Boolean	True	Indicates whether a client can create a contents table.
EffectiveRights_CreateHierarchy	Boolean	True	Indicates whether a client can create a hierarchy table.
EffectiveRights_Delete	Boolean	True	Indicates whether a client can delete a folder or item.
EffectiveRights_Modify	Boolean	True	Indicates whether a client can modify a folder or item.
EffectiveRights_Read	Boolean	True	Indicates whether a client can read a folder or item.
EffectiveRights_ViewPrivateItems	Boolean	True	Indicates whether a private item can be viewed.
ReceivedByName	String	False	Defines the name of the ReceivedBy mailbox user.
ReceivedByEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ReceivedBy mailbox user.
ReceivedByRoutingType	String	False	Defines the routing that is used for the ReceivedBy mailbox. The default is SMTP.
ReceivedRepresentingName	String	False	Defines the name of the ReceivedRepresenting mailbox user.
ReceivedRepresentingEmailAddress	String	False	Defines the Simple Mail Transfer Protocol (SMTP) address of the ReceivedRepresenting mailbox user.
ReceivedRepresentingRoutingType	String	False	Defines the routing that is used for the ReceivedRepresenting mailbox. The default is SMTP.
LastModifiedName	String	True	Contains the display name of the last user to modify an item.
LastModifiedTime	Datetime	True	Indicates when an item was last modified. This element is read-only.
IsAssociated	Boolean	False	Indicates whether the item is associated with a folder.
WebClientReadFormQueryString	String	True	Represents a URL to concatenate to the Microsoft Office Outlook Web App endpoint to read an item in Outlook Web App.
WebClientEditFormQueryString	String	True	Represents a URL to concatenate to the Outlook Web App endpoint to edit an item in Outlook Web App.
ConversationId	String	True	Identifies a specific conversation in the Exchange store.
ConversationChangeKey	String	True	Contains the change key of an item or conversation.
UniqueBody	String	True	Represents an HTML fragment or plain-text which represents the unique body of this conversation.
UniqueBodyType	String	True	Describes how the unique item body is stored in the item (HTML or TEXT).
ReminderMessageData_Text	String	False	Specifies the text of a reminder message.
ReminderMessageData_Location	String	False	Represents the location of a meeting, appointment, or persona.
ReminderMessageData_StartTime	Datetime	False	Specifies the starting time of the item that the reminder is for.
ReminderMessageData_EndTime	Datetime	False	Specifies the ending time of the item that the reminder is for.
ReminderMessageData_AssociatedCalendarId	String	True	Represents the calendar item that is associated with the ReminderMessageData.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
ImpersonationUser	String	The Identifier of the user to impersonate.
ImpersonationType	String	The type of Identifier used for the impersonation user (PrincipalName, SID, PrimarySmtpAddress, SmtpAddress).

Tasks

Create, update, delete, and query Tasks items.

テーブル固有の情報

Update およびDelete

Cloud では、アイテムの更新および削除にはItemChangeKey が必要です。ただし、ItemChangeKey が不明な場合には、Cloud は自動的にExchange サーバーからこれを取得することができます。これはクエリ実行にかかる時間を増加させることに注意してください。

繰り返しフィールド

タスクの繰り返しフィールドのINSERT、SELECT、もしくはUPDATE には、Recurrence_Type およびRecurrence_Duration fields に紐付いたフィールドのみを設定します。次のテーブルを参照してください：

Recurrence_Type Values & Associated Fields


RelativeYearlyRecurrence	Recurrence_DaysOfWeek, Recurrence_DaysOfWeekIndex, Recurrence_Month
AbsoluteYearlyRecurrence	Recurrence_DayOfMonth, Recurrence_Month
RelativeMonthlyRecurrence	Recurrence_Interval, Recurrence_DaysOfWeek, Recurrence_DaysOfWeekIndex
AbsoluteMonthlyRecurrence	Recurrence_Interval, Recurrence_DayOfMonth
WeeklyRecurrence	Recurrence_Interval, Recurrence_DaysOfWeek, Recurrence_FirstDayOfWeek
Daily	Recurrence_Interval
*Regeneration	Recurrence_Interval

Recurrence_Duration & Associated Fields


NoEndRecurrence	Recurrence_StartDate
EndDateRecurrence	Recurrence_StartDate, Recurrence_EndDate
NumberedRecurrence	Recurrence_StartDate, Recurrence_NumberOfOccurrences

Columns


Name	Type	ReadOnly	Description
MimeContent	String	True	Contains the native Multipurpose Internet Mail Extensions (MIME) stream of an object that is represented in Base64 binary format.
ItemId [KEY]	String	True	Contains the unique identifier of an item in the Exchange store. This property is read-only.
ItemChangeKey	String	True	Contains the unique change key of an item in the Exchange store. This property is read-only.
ParentFolderId	String	False	Represents the unique identifier of the parent folder that contains the item or folder. This property is read-only.
ParentFolderChangeKey	String	True	Represents the unique change key of the parent folder that contains the item or folder. This property is read-only.
ItemClass	String	False	Represents the message class of an item.
Subject	String	False	Represents the subject for Exchange store items and response objects. The subject is limited to 255 characters.
Sensitivity	String	True	Indicates the sensitivity level of an item.
DateTimeReceived	Datetime	True	Represents the date and time that an item in a mailbox was received.
Size	Integer	True	Represents the size in bytes of an item. This property is read-only.
Categories	String	False	Represents a collection of strings that identify to which categories an item in the mailbox belongs.
InReplyTo	String	True	Represents the identifier of the item to which this item is a reply.
IsSubmitted	Boolean	True	Indicates whether an item has been submitted to the Outbox default folder.
IsDraft	Boolean	True	Represents whether an item has not yet been sent.
IsFromMe	Boolean	True	Indicates whether a user sent an item to himself or herself.
IsResend	Boolean	True	Indicates whether the item had previously been sent.
IsUnmodified	Boolean	True	Indicates whether the item has been modified.
InternetMessageHeaders	String	True	Represents the collection of all Internet message headers that are contained within an item in a mailbox.
DateTimeSent	Datetime	True	Represents the date and time that an item in a mailbox was sent.
DateTimeCreated	Datetime	True	Represents the date and time that a given item in the mailbox was created.
ReminderDueBy	Datetime	False	Represents the date and time when the event occurs.
ReminderIsSet	Boolean	False	Indicates whether a reminder has been set for an item in the Exchange store.
ReminderMinutesBeforeStart	Integer	False	Represents the number of minutes before an event occurs when a reminder is displayed.
DisplayCc	String	True	Represents the display string that is used for the contents of the To box. This is the concatenated string of all To recipient display names.
DisplayTo	String	True	Represents a property that is set to true if an item has at least one visible attachment. This property is read-only.
HasAttachments	Boolean	True	Indicates whether an item has attachments.
Culture	String	False	Represents the Culture of an item.
ActualWork	Integer	False	Represents the actual amount of time that is spent on a task.
AssignedTime	Datetime	False	Represents the time when a task is assigned to a contact.
BillingInformation	String	False	Holds billing information for a task.
ChangeCount	Integer	False	Specifies the version of the task.
Companies1	String	False	Represents the collection of companies that are associated with a contact or task.
Companies2	String	False	Represents the collection of companies that are associated with a contact or task.
Companies3	String	False	Represents the collection of companies that are associated with a contact or task.
CompleteDate	Datetime	False	Represents the date on which a task is completed.
Contacts1	String	False	Contains a list of contacts who are associated with a task.
Contacts2	String	False	Contains a list of contacts who are associated with a task.
Contacts3	String	False	Contains a list of contacts who are associated with a task.
DelegationState	String	False	Represents the status of a delegated task.
Delegator	String	False	Contains the name of the delegator who assigned the task.
DueDate	Datetime	False	Represents the date when a task item is due.
IsAssignmentEditable	Boolean	False	Indicates whether the task is editable or not.
IsComplete	Boolean	False	Indicates whether the task has been completed or not.
IsRecurring	Boolean	True	Indicates whether a task is part of a recurring item.
IsTeamTask	Boolean	False	Indicates whether the task is owned by a team or not.
Mileage	String	False	Represents mileage for a task item.
Owner	String	False	Represents the owner of a task.
PercentComplete	Double	False	Describes the completion status of a task.
Recurrence_Type	String	False	Contains the recurrence type for task items and meeting requests. 使用できる値は次のとおりです。RelativeYearlyRecurrence, AbsoluteYearlyRecurrence, RelativeMonthlyRecurrence, AbsoluteMonthlyRecurrence, WeeklyRecurrence, DailyRecurrence, DailyRegeneration, WeeklyRegeneration, MonthlyRegeneration, YearlyRegeneration
Recurrence_DaysOfWeek	String	False	Describes days of the week that are used in item recurrence patterns.
Recurrence_DayOfWeekIndex	String	False	Describes which week in a month is used in a relative yearly recurrence pattern. 使用できる値は次のとおりです。First, Second, Third, Fourth, Last
Recurrence_Month	String	False	Describes the month when a yearly recurring item occurs.
Recurrence_DayOfMonth	Integer	False	Describes the day in a month on which a recurring item occurs.
Recurrence_Interval	Integer	False	Defines the interval between two consecutive recurring items.
Recurrence_FirstDayOfWeek	String	False	Specifies the first day of the week.
Recurrence_Duration	String	False	Contains the recurrence duration type for task items and meeting requests. 使用できる値は次のとおりです。NoEndRecurrence, EndDateRecurrence, NumberedRecurrence
Recurrence_StartDate	Datetime	False	Represents the start date of a recurring task or calendar item.
Recurrence_EndDate	Datetime	False	Represents the end date of a recurring task or calendar item.
Recurrence_NumberOfOccurences	Integer	False	Contains the number of occurrences of a recurring item.
StartDate	Datetime	False	Represents the start date of a task item.
Status	String	False	Represents the status of a task item.
StatusDescription	String	True	Contains an explanation of the task status.
TotalWork	Integer	False	Contains a description of how much work is associated with an item.
EffectiveRights_CreateAssociated	Boolean	True	Indicates whether a client can create an associated contents table.
EffectiveRights_CreateContents	Boolean	True	Indicates whether a client can create a contents table.
EffectiveRights_CreateHierarchy	Boolean	True	Indicates whether a client can create a hierarchy table.
EffectiveRights_Delete	Boolean	True	Indicates whether a client can delete a folder or item.
EffectiveRights_Modify	Boolean	True	Indicates whether a client can modify a folder or item.
EffectiveRights_Read	Boolean	True	Indicates whether a client can read a folder or item.
EffectiveRights_ViewPrivateItems	Boolean	True	Indicates whether a private item can be viewed.
LastModifiedName	String	True	Contains the display name of the last user to modify an item.
LastModifiedTime	Datetime	True	Indicates when an item was last modified.
IsAssociated	Boolean	False	Indicates whether the item is associated with a folder.
WebClientReadFormQueryString	String	True	Represents a URL to concatenate to the Microsoft Office Outlook Web App endpoint to read an item in Outlook Web App.
WebClientEditFormQueryString	String	True	Represents a URL to concatenate to the Outlook Web App endpoint to edit an item in Outlook Web App.
ConversationId	String	True	Contains the identifier of an item or conversation.
ConversationChangeKey	String	True	Contains the change key of an item or conversation.
UniqueBody	String	True	Represents an HTML fragment or plain-text which represents the unique body of this conversation.
UniqueBodyType	String	True	Describes how the unique item body is stored in the item (HTML or TEXT).

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
ImpersonationUser	String	The Identifier of the user to impersonate.
ImpersonationType	String	The type of Identifier used for the impersonation user (PrincipalName, SID, PrimarySmtpAddress, SmtpAddress).

ストアドプロシージャ

ストアドプロシージャはファンクションライクなインターフェースで、Microsoft Exchange の単純なSELECT/INSERT/UPDATE/DELETE 処理にとどまらずCloud の機能を拡張します。

ストアドプロシージャは、パラメータのリストを受け取り、目的の機能を実行し、プロシージャが成功したか失敗したかを示すとともにMicrosoft Exchange から関連するレスポンスデータを返します。

CData Cloud - Microsoft Exchange ストアドプロシージャ


Name	Description
CreateAttachments	Create and add a attachment to an existing email.
GetAttachment	Retrieves the indicated attachments.
GetUserOofSettings	Provides access to the OOF settings of a user. A user is identified by the email address of the user. If the OOF message is null and OOF is enabled, no OOF message is sent.
MoveItem	Move messages from one folder to another.
SendItem	Send an email message that is located in the Exchange store.
SendMail	Send a new email to the specified recipients.

CreateAttachments

Create and add a attachment to an existing email.

Stored Procedure Specific Information

Use CreateAttachments procedure to add an attachment to an existing email. To specify file paths of the attachments use Attachments input, whereas for base 64 encoded content specify AttachmentContent and AttachmentName.

EXECUTE CreateAttachments ItemId = 'AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD/FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAxEAAABDJHYjDdygQ5pQPUEu3S2cAAVZoayvAAAA', Attachments = 'C:\Users\User\Desktop\logfile.txt,C:\Users\User\Desktop\TestConnectionLog.txt'

Input


Name	Type	Required	Description
ItemId	String	True	The id of the email item to add the attachment to.
Attachments	String	False	The attachment to be added.
AttachmentContent	String	False	The attachment content base 64 encoded.
AttachmentName	String	False	The name of the file that will be created out of the attachment content.

Result Set Columns


Name	Type	Description
AttachmentIds	String	The id of the attachment created

GetAttachment

Retrieves the indicated attachments.

Input


Name	Type	Required	Description
AttachmentIds	String	True	A semicolon-separated list of the Ids of the attachments to retrieve.
IncludeMimeContent	String	False	Specifies whether the Multipurpose Internet Mail Extensions (MIME) content of an item or attachment is returned in the response. This element is optional.
BodyType	String	False	Identifies how the body text is formatted in the response. This element is optional. Valid values are: Best, HTML, Text.
AttachmentFolder	String	False	Folder to download attachments to.
Overwrite	String	False	If true, conflicting files will be overwritten, otherwise they will be indexed. デフォルト値はtrueです。

Result Set Columns


Name	Type	Description
AttachmentId	String	Identifies the file attachment.
Name	String	Represents the name of the attachment.
ContentType	String	Describes the Multipurpose Internet Mail Extensions (MIME) type of the attachment content.
ContentId	String	Represents an identifier for the contents of an attachment. ContentId can be set to any string value. Applications can use ContentId to implement their own identification mechanisms.
ContentLocation	String	Contains the Uniform Resource Identifier (URI) that corresponds to the location of the content of the attachment.
Size	String	Represents the size in bytes of the file attachment.
LastModifiedTime	String	Represents when the file attachment was last modified.
IsInline	String	Represents whether the attachment appears in-line within an item.
IsContactPhoto	String	Indicates whether the file attachment is a contact picture.
Content	String	Contains the Base64-encoded contents of the file attachment.

GetUserOofSettings

Provides access to the OOF settings of a user. A user is identified by the email address of the user. If the OOF message is null and OOF is enabled, no OOF message is sent.

Input


Name	Type	Required	Description
User	String	False	The email address of the user whose OOF settings to retreive.
ImpersonationUser	String	False	The email address of the user to impersonate when requesting OOF settings.
ImpersonationType	String	False	The type of Identifier used for the impersonation user (PrincipalName, SID, PrimarySmtpAddress, SmtpAddress).

Result Set Columns


Name	Type	Description
OofState	String	The user's Out of Office (OOF) state. (Disabled or Enabled or Scheduled)
ExternalAudience	String	The value that determines to whom external Out of Office (OOF) messages are sent. (None or Known or All)
StartTime	String	Represents the start of the time span set with an OOF status.
EndTime	String	Represents the end of the time span set with an OOF status.
InternalReply	String	The out of office (OOF) response sent to other users in the user's domain or trusted domains.
ExternalReply	String	The out of office (OOF) response that is sent to addresses outside the recipient's domain or trusted domains.

MoveItem

Move messages from one folder to another.

Input


Name	Type	Required	Description
ItemId	String	False	The unique ItemId of the item to be sent (required).
ItemChangekey	String	False	The unique ItemChangeKey of the item to be sent (required).
FolderDisplayName	String	False	The display name of the new folder.

Result Set Columns


Name	Type	Description
ResponseClass	String	The overall class of the response for the SendItem operation (Success/Warning/Error).
ResponseCode	String	A response code for the SendItem operation.
MessageText	String	Specific message text describing any errors or warning for the SendItem operation.

SendItem

Send an email message that is located in the Exchange store.

Input


Name	Type	Required	Description
ItemId	String	True	The unique ItemId of the item to be sent (required).
ItemChangekey	String	True	The unique ItemChangeKey of the item to be sent (required).
SaveToFolder	String	False	Boolean value to determine whether or not to save the item.
SavedItemFolder	String	False	The folder where the item will be saved. This value can be the name of any of the standard folders or the FolderId of a custom folder. Defaults to SentItems.

Result Set Columns


Name	Type	Description
ResponseClass	String	The overall class of the response for the SendItem operation (Success/Warning/Error).
ResponseCode	String	A response code for the SendItem operation.
MessageText	String	Specific message text describing any errors or warning for the SendItem operation.

SendMail

Send a new email to the specified recipients.

Stored Procedure Specific Information

You can send a mail with attachments, specifying one or more file paths or the base 64 content of the attachment. To specify file paths use Attachments input, whereas for base 64 encoded content specify AttachmentContent and AttachmentName. Note that if the file location specified in the 'Attachments' input is a folder, than all the files of the first level in that folder will be sent as attachments.

EXECUTE SendMail Subject = 'Issue with CData Cloud', Content = 'I am not being able to connect to Microsoft Exchange', Attachments = 'C:\Users\User\Desktop\logfile.txt,C:\Users\User\Desktop\TestConnectionLog.txt', ToRecipients = '[email protected]'

You can include CC and BCC recipients and send the mail. To specify one or more recipients, separate them using ','.

EXECUTE SendMail Subject = 'Issue with CData Cloud', Content = 'I am am not being able to connect to Microsoft Exchange', ToRecipients = '[email protected]', CcRecipients = '[email protected], [email protected], [email protected]', BccRecipients = '[email protected]'

Input


Name	Type	Required	Description
Subject	String	True	The email subject.
Content	String	True	Email body content.
Attachments	String	False	The attachments. Specify the filepaths of the files you want to attach in the following format: 'filepath1,filepath2'.
AttachmentContent	String	False	The attachment content base 64 encoded.
AttachmentName	String	False	The name of the file that will be created out of the attachment content.
ToRecipients	String	True	The recipients. Specify recipients in the following format: '[email protected],[email protected]'.
CcRecipients	String	False	The Cc: recipients for the message. Specify recipients in the following format: '[email protected],[email protected]'.
BccRecipients	String	False	The Bcc: recipients for the message. Specify recipients in the following format: '[email protected],[email protected]'.

MSGraph データモデル

CData Cloud は、Microsoft Exchange オブジェクトをリレーショナルテーブルおよびビューとしてモデル化します。 Microsoft Exchange オブジェクトは他のオブジェクトとリレーションを持ちます。テーブルでは、これらのリレーションは外部キーを使用して表されます。次のセクションでは、利用可能なAPI オブジェクトを示し、Microsoft Exchange API へのSQL の実行について詳しく説明します。

ほとんどのデータベースオブジェクトのスキーマは、シンプルなテキストベースのコンフィギュレーションファイルで定義されます。

テーブル

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

CData Cloud - Microsoft Exchange テーブル


Name	Description
CalendarGroups	CalendarGroups table for Exchange data provider.
Calendars	Calendars table for Exchange data provider.
Contacts	Contacts table for Exchange data provider.
Events	Events table for Exchange data provider.
ExtendedProperties	Create, update, delete, and query Contacts items.
Groups	Groups table for Exchange data provider.
MailFolders	MailFolders table for Exchange data provider.
Messages	Messages table for Exchange data provider.
Users	Users table for Exchange data provider.

CalendarGroups

CalendarGroups table for Exchange data provider.

Columns


Name	Type	ReadOnly	Description
id [KEY]	String	False
changeKey	String	False
classId	String	False
name	String	False

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
userId	String

Calendars

Calendars table for Exchange data provider.

テーブル固有の情報

Select

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

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

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

SELECT Name FROM Calendars WHERE Name LIKE 'John Calendar%'

Note：AlwaysRequstTableDependencies 接続プロパティを指定、あるいは参照CalendarGroupId で選択またはフィルタリングしない限り、CalendarGroupId の値はNull のままです。

Insert

新しいCalendar を作成するには、Name を最低限に指定します。

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

Columns


Name	Type	ReadOnly	Description
calendarGroupId	String	False
id [KEY]	String	False
canEdit	Bool	False
canShare	Bool	False
canViewPrivateItems	Bool	False
changeKey	String	False
color	String	False
name	String	False
owner_name	String	False
owner_address	String	False

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
userId	String

Contacts

Contacts table for Exchange data provider.

テーブル固有の情報

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')

Columns


Name	Type	ReadOnly	Description
id [KEY]	String	False
categories	String	False
changeKey	String	False
createdDateTime	Datetime	False
lastModifiedDateTime	Datetime	False
assistantName	String	False
birthday	Datetime	False
businessAddress_street	String	False
businessAddress_city	String	False
businessAddress_state	String	False
businessAddress_countryOrRegion	String	False
businessAddress_postalCode	String	False
businessHomePage	String	False
businessPhones	String	False
children	String	False
companyName	String	False
department	String	False
displayName	String	False
emailAddresses	String	False
fileAs	String	False
generation	String	False
givenName	String	False
homeAddress_street	String	False
homeAddress_city	String	False
homeAddress_state	String	False
homeAddress_countryOrRegion	String	False
homeAddress_postalCode	String	False
homePhones	String	False
imAddresses	String	False
initials	String	False
jobTitle	String	False
manager	String	False
middleName	String	False
mobilePhone	String	False
nickName	String	False
officeLocation	String	False
otherAddress_street	String	False
otherAddress_city	String	False
otherAddress_state	String	False
otherAddress_countryOrRegion	String	False
otherAddress_postalCode	String	False
parentFolderId	String	False
personalNotes	String	False
profession	String	False
spouseName	String	False
surname	String	False
title	String	False
yomiCompanyName	String	False
yomiGivenName	String	False
yomiSurname	String	False

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
userId	String

Events

Events table for Exchange data provider.

テーブル固有の情報

Select

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

Note：AlwaysRequstTableDependencies 接続プロパティを指定、あるいは参照カラムCalendarId で選択またはフィルタリングしない限り、CalendarId の値はNull のままです。

Note: To retrieve all Events for Other user (Works only in case of OAuthGrantType=CLIENT), you can specify the query like -

SELECT * FROM Events WHERE UserId = '0409f710-2aa9-4f05-8944-ef382160f1d1' AND CalendarId IN (SELECT Id FROM Calendars WHERE UserId = '0409f710-2aa9-4f05-8944-ef382160f1d1')

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：デフォルトで、このステートメントはイベントをデフォルトカレンダー内に作成します。

Columns


Name	Type	ReadOnly	Description
id [KEY]	String	False
categories	String	False
changeKey	String	False
createdDateTime	Datetime	False
lastModifiedDateTime	Datetime	False
attendees	String	False
body_contentType	String	False
body_content	String	False
bodyPreview	String	False
end_dateTime	String	False
end_timeZone	String	False
hasAttachments	Bool	False
iCalUId	String	False
importance	String	False
isAllDay	Bool	False
isCancelled	Bool	False
isOrganizer	Bool	False
isReminderOn	Bool	False
location_displayName	String	False
location_locationEmailAddress	String	False
location_address_street	String	False
location_address_city	String	False
location_address_state	String	False
location_address_countryOrRegion	String	False
location_address_postalCode	String	False
location_coordinates_altitude	Double	False
location_coordinates_latitude	Double	False
location_coordinates_longitude	Double	False
location_coordinates_accuracy	Double	False
location_coordinates_altitudeAccuracy	Double	False
location_locationUri	String	False
location_locationType	String	False
location_uniqueId	String	False
location_uniqueIdType	String	False
locations	String	False
onlineMeetingUrl	String	False
organizer_emailAddress_name	String	False
organizer_emailAddress_address	String	False
originalEndTimeZone	String	False
originalStart	Datetime	False
originalStartTimeZone	String	False
recurrence_pattern_type	String	False
recurrence_pattern_interval	Int	False
recurrence_pattern_month	Int	False
recurrence_pattern_dayOfMonth	Int	False
recurrence_pattern_daysOfWeek	String	False
recurrence_pattern_firstDayOfWeek	String	False
recurrence_pattern_index	String	False
recurrence_range_type	String	False
recurrence_range_startDate	Date	False
recurrence_range_endDate	Date	False
recurrence_range_recurrenceTimeZone	String	False
recurrence_range_numberOfOccurrences	Int	False
reminderMinutesBeforeStart	Int	False
responseRequested	Bool	False
responseStatus_response	String	False
responseStatus_time	Datetime	False
sensitivity	String	False
seriesMasterId	String	False
showAs	String	False
start_dateTime	String	False
start_timeZone	String	False
subject	String	False
transactionId	String	False
type	String	False
webLink	String	False
calendarId	String	False

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
groupId	String
userId	String

ExtendedProperties

Create, update, delete, and query Contacts items.

Table Specific Information

Select

You can query ExtendedProperties for a specific resource from the following resources: Events, Calendars and Messages. In order to get the value for an extended property you need to specify: - Entity field, wether it is Message, Event or Calendar - EntityId, the Id of the resource - Id, the id of the extended property.

SELECT * FROM ExtendedProperties WHERE Entity = 'Event' AND EntityId = 'AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD-FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAw8AAABDJHYjDdygQ5pQPUEu3S2cAAZq-GA0AAAA' AND Id = 'String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color'

Insert

You can create an extended property in a resource, by specifying Entity, EntityId, Id of the extended property and its Value.

INSERT INTO ExtendedProperties (Entity, EntityId, Id, Value) VALUES ('Calendar', 'AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD-FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAwcAAABDJHYjDdygQ5pQPUEu3S2cAASHbEoeAAAA', 'String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color', 'Yellow')

Columns


Name	Type	ReadOnly	Description
Id	String	False	The Identifier of the extended property
Value	String	False	The value of the extended property
Entity	String	False	The entity type.
EntityId	String	False	The entity id that the extended properties belong to.

Groups

Groups table for Exchange data provider.

テーブル固有の情報

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

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 Name = 'test'

Insert

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

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

Columns


Name	Type	ReadOnly	Description
id [KEY]	String	False
deletedDateTime	Datetime	False
allowExternalSenders	Bool	False
assignedLicenses	String	False
autoSubscribeNewMembers	Bool	False
classification	String	False
createdDateTime	Datetime	False
description	String	False
displayName	String	False
groupTypes	String	False
hasMembersWithLicenseErrors	Bool	False
isArchived	Bool	False
isSubscribedByMail	Bool	False
licenseProcessingState_state	String	False
mail	String	False
mailEnabled	Bool	False
mailNickname	String	False
onPremisesLastSyncDateTime	Datetime	False
onPremisesProvisioningErrors	String	False
onPremisesSecurityIdentifier	String	False
onPremisesSyncEnabled	Bool	False
preferredDataLocation	String	False
proxyAddresses	String	False
renewedDateTime	Datetime	False
securityEnabled	Bool	False
unseenCount	Int	False
visibility	String	False

MailFolders

MailFolders table for Exchange data provider.

Columns


Name	Type	ReadOnly	Description
id [KEY]	String	False
childFolderCount	Int	False
displayName	String	False
parentFolderId	String	False
totalItemCount	Int	False
unreadItemCount	Int	False

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
userId	String

Messages

Messages table for Exchange data provider.

テーブル固有の情報

Select

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

SELECT * FROM Messages WHERE Id = 'MyMessageId'

SELECT * FROM Messages WHERE ParentFolderId = 'MyParentfolderId' 

SELECT * FROM Messages WHERE ParentFolderId = 'Drafts'

Note：AlwaysRequstTableDependencies 接続プロパティを指定、あるいは参照カラムParentFolderId で選択またはフィルタリングしない限り、ParentFolderId の値はNull のままです。

Insert

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

INSERT INTO Messages (Subject, Body_Content) VALUES ('New test Email', 'Test Email created.')

Columns


Name	Type	ReadOnly	Description
id [KEY]	String	False
categories	String	False
changeKey	String	False
createdDateTime	Datetime	False
lastModifiedDateTime	Datetime	False
bccRecipients	String	False
body_contentType	String	False
body_content	String	False
bodyPreview	String	False
ccRecipients	String	False
conversationId	String	False
flag_completedDateTime_dateTime	String	False
flag_completedDateTime_timeZone	String	False
flag_flagStatus	String	False
from_emailAddress_name	String	False
from_emailAddress_address	String	False
hasAttachments	Bool	False
importance	String	False
inferenceClassification	String	False
internetMessageHeaders	String	False
internetMessageId	String	False
isDeliveryReceiptRequested	Bool	False
isDraft	Bool	False
isRead	Bool	False
isReadReceiptRequested	Bool	False
parentFolderId	String	False
receivedDateTime	Datetime	False
replyTo	String	False
sender_emailAddress_name	String	False
sender_emailAddress_address	String	False
sentDateTime	Datetime	False
subject	String	False
toRecipients	String	False
uniqueBody_contentType	String	False
uniqueBody_content	String	False
webLink	String	False

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
userId	String

Users

Users table for Exchange data provider.

テーブル固有の情報

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	Description
id [KEY]	String	False
deletedDateTime	Datetime	False
aboutMe	String	False
accountEnabled	Bool	False
ageGroup	String	False
assignedLicenses	String	False
assignedPlans	String	False
birthday	Datetime	False
businessPhones	String	False
city	String	False
companyName	String	False
consentProvidedForMinor	String	False
country	String	False
department	String	False
deviceEnrollmentLimit	Int	False
displayName	String	False
employeeId	String	False
faxNumber	String	False
givenName	String	False
hireDate	Datetime	False
imAddresses	String	False
interests	String	False
isResourceAccount	Bool	False
jobTitle	String	False
legalAgeGroupClassification	String	False
licenseAssignmentStates	String	False
mail	String	False
mailboxSettings_automaticRepliesSetting_status	String	False
mailboxSettings_automaticRepliesSetting_externalAudience	String	False
mailboxSettings_automaticRepliesSetting_scheduledStartDateTime_dateTime	String	False
mailboxSettings_automaticRepliesSetting_scheduledStartDateTime_timeZone	String	False
mailboxSettings_automaticRepliesSetting_internalReplyMessage	String	False
mailboxSettings_automaticRepliesSetting_externalReplyMessage	String	False
mailboxSettings_archiveFolder	String	False
mailboxSettings_timeZone	String	False
mailboxSettings_language_locale	String	False
mailboxSettings_language_displayName	String	False
mailboxSettings_workingHours_daysOfWeek	String	False
mailboxSettings_workingHours_startTime	Time	False
mailboxSettings_workingHours_endTime	Time	False
mailboxSettings_workingHours_timeZone_name	String	False
mailNickname	String	False
mobilePhone	String	False
mySite	String	False
officeLocation	String	False
onPremisesDistinguishedName	String	False
onPremisesDomainName	String	False
onPremisesExtensionAttributes_extensionAttribute1	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
onPremisesExtensionAttributes_extensionAttribute10	String	False
onPremisesExtensionAttributes_extensionAttribute11	String	False
onPremisesExtensionAttributes_extensionAttribute12	String	False
onPremisesExtensionAttributes_extensionAttribute13	String	False
onPremisesExtensionAttributes_extensionAttribute14	String	False
onPremisesExtensionAttributes_extensionAttribute15	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
passwordPolicies	String	False
passwordProfile_password	String	False
passwordProfile_forceChangePasswordNextSignIn	Bool	False
passwordProfile_forceChangePasswordNextSignInWithMfa	Bool	False
pastProjects	String	False
postalCode	String	False
preferredLanguage	String	False
preferredName	String	False
provisionedPlans	String	False
proxyAddresses	String	False
responsibilities	String	False
schools	String	False
showInAddressList	Bool	False
signInSessionsValidFromDateTime	Datetime	False
skills	String	False
state	String	False
streetAddress	String	False
surname	String	False
usageLocation	String	False
userPrincipalName	String	False
userType	String	False

ビュー

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

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

CData Cloud - Microsoft Exchange ビュー


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 Exchange data provider.
EventInstances	EventInstances View for Exchange data provider.
GroupMembers	Group Members table for Exchange data provider.
MessageAttachments	MessageAttachments View for Exchange data provider.

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 are returned. You can filter results by CalendarId, Start_DateTime, End_DateTime.

For example the following queries are 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='

NOTE Unless specifying the AlwaysRequestTableDependencies connection property or selecting/filtering by the reference column CalendarId, the value for CalendarId remains null.

Columns

Description [KEY] String String String Datetime Datetime String String String String String String Bool String String Bool Bool Bool Bool String String String String String String String Double Double Double Double Double String String String String String String String String String Datetime String String Int Int Int String String String String Date Date String Int Int Bool String Datetime String String String String String String String String String


Name	Type
id
categories
changeKey
createdDateTime
lastModifiedDateTime
attendees
body_contentType
body_content
bodyPreview
end_dateTime
end_timeZone
hasAttachments
iCalUId
importance
isAllDay
isCancelled
isOrganizer
isReminderOn
location_displayName
location_locationEmailAddress
location_address_street
location_address_city
location_address_state
location_address_countryOrRegion
location_address_postalCode
location_coordinates_altitude
location_coordinates_latitude
location_coordinates_longitude
location_coordinates_accuracy
location_coordinates_altitudeAccuracy
location_locationUri
location_locationType
location_uniqueId
location_uniqueIdType
locations
onlineMeetingUrl
organizer_emailAddress_name
organizer_emailAddress_address
originalEndTimeZone
originalStart
originalStartTimeZone
recurrence_pattern_type
recurrence_pattern_interval
recurrence_pattern_month
recurrence_pattern_dayOfMonth
recurrence_pattern_daysOfWeek
recurrence_pattern_firstDayOfWeek
recurrence_pattern_index
recurrence_range_type
recurrence_range_startDate
recurrence_range_endDate
recurrence_range_recurrenceTimeZone
recurrence_range_numberOfOccurrences
reminderMinutesBeforeStart
responseRequested
responseStatus_response
responseStatus_time
sensitivity
seriesMasterId
showAs
start_dateTime
start_timeZone
subject
type
webLink
calendarId

EventAttachments

EventAttachments View for Exchange data provider.

テーブル固有の情報

Select

Event Id（必須）を指定してEventAttachments をクエリできます。

SELECT * FROM [EventAttachments] WHERE EventId = 'event id'

このクエリは、指定されたEvent の添付ファイルを、コンテンツを含めずにリストとして取得します。

Columns


Name	Type	Description
eventId	String
id [KEY]	String
contentType	String
isInline	Bool
lastModifiedDateTime	Datetime
name	String
size	Int
userId	String

EventInstances

EventInstances View for Exchange data provider.

Table Specific Information

Select

You can query EventInstances 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 [EventInstances] WHERE id = 'event id' AND StartDateTime = '2018/01/01' AND EndDateTime = '2018/12/31'

SELECT * FROM [EventInstances] WHERE id = 'event id'

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

Columns


Name	Type	Description
eventId	String
id [KEY]	String
categories	String
changeKey	String
createdDateTime	Datetime
lastModifiedDateTime	Datetime
attendees	String
body_contentType	String
body_content	String
bodyPreview	String
end_dateTime	String
end_timeZone	String
hasAttachments	Bool
iCalUId	String
importance	String
isAllDay	Bool
isCancelled	Bool
isOrganizer	Bool
isReminderOn	Bool
location_displayName	String
location_locationEmailAddress	String
location_address_street	String
location_address_city	String
location_address_state	String
location_address_countryOrRegion	String
location_address_postalCode	String
location_coordinates_altitude	Double
location_coordinates_latitude	Double
location_coordinates_longitude	Double
location_coordinates_accuracy	Double
location_coordinates_altitudeAccuracy	Double
location_locationUri	String
location_locationType	String
location_uniqueId	String
location_uniqueIdType	String
locations	String
onlineMeetingUrl	String
organizer_emailAddress_name	String
organizer_emailAddress_address	String
originalEndTimeZone	String
originalStart	Datetime
originalStartTimeZone	String
recurrence_pattern_type	String
recurrence_pattern_interval	Int
recurrence_pattern_month	Int
recurrence_pattern_dayOfMonth	Int
recurrence_pattern_daysOfWeek	String
recurrence_pattern_firstDayOfWeek	String
recurrence_pattern_index	String
recurrence_range_type	String
recurrence_range_startDate	Date
recurrence_range_endDate	Date
recurrence_range_recurrenceTimeZone	String
recurrence_range_numberOfOccurrences	Int
reminderMinutesBeforeStart	Int
responseRequested	Bool
responseStatus_response	String
responseStatus_time	Datetime
sensitivity	String
seriesMasterId	String
showAs	String
start_dateTime	String
start_timeZone	String
subject	String
type	String
webLink	String

GroupMembers

Group Members table for Exchange data provider.

Table Specific Information

Groups require Administrator permissions. To work with them, you must create your own custom OAuth App and set the appropriate OAuthClientId and OAuthClientSecret. In this app, you must configure it to request the GroupMember.Read.All and the GroupMember.ReadWrite.All permissions. This can be done at https://apps.dev.microsoft.com, or in the App Registrations panel at http://portal.azure.com.

To authorize GroupMembers permissions, an administrator must grant the GroupMembers permissions for your organization at large. This can be done via the administrator authorization endpoint. Simply have the administrator navigate to the following web page and grant permissions. Then run the OAuth authorization as normal afterwards.

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

Note that if your organization has multiple tenants, you may replace the /common/ in the url with the tenant id to indicate which tenant to grant permissions for.

Select

The Cloud uses the Microsoft Exchange API to process WHERE clause conditions. The rest of the filter is executed client-side in the Cloud.

For example, the following query is processed server-side:

SELECT * FROM GroupMembers

Columns


Name	Type	Description
Id [KEY]	String
GroupId	String
AssistantName	String
BusinessPhones	String
Classification	String
CreatedDateTime	Datetime
CreationOptions	String
DeletedDateTime	Datetime
Description	String
DisplayName	String
ExpirationDateTime	Datetime
GivenName	String
GroupTypes	String
IsAssignableToRole	Boolean
JobTitle	String
Mail	String
MailEnabled	Bool
MailNickname	String
MembershipRule	String
MembershipRuleProcessingState	String
MobilePhone	String
OfficeLocation	String
OnPremisesDomainName	String
OnPremisesLastSyncDateTime	Datetime
OnPremisesNetBiosName	String
OnPremisesProvisioningErrors	String
OnPremisesSamAccountName	String
OnPremisesSecurityIdentifier	String
OnPremisesSyncEnabled	Bool
PreferredDataLocation	String
PreferredLanguage	String
ProxyAddresses	String
RenewedDateTime	Datetime
SecurityEnabled	Bool
Surname	String
UserPrincipalName	String
Visibility	String

MessageAttachments

MessageAttachments View for Exchange data provider.

テーブル固有の情報

Select

Message Id（必須）を指定してMessageAttachments をクエリできます。

SELECT * FROM [MessageAttachments] WHERE MessageId = 'message id'
SELECT * FROM [MessageAttachments] WHERE UserId = '92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe' AND Id = 'AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD-FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAw4AAABDJHYjDdygQ5pQPUEu3S2cAAhJYnE3AAAAARIAEADUFdfqaYanT5_pTPvzgMYh' AND MessageId = 'AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD-FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAw4AAABDJHYjDdygQ5pQPUEu3S2cAAhJYnE3AAAA'

このクエリは、指定されたMessage の添付ファイルを、コンテンツを含めずにリストとして取得します。

Columns


Name	Type	Description
messageId	String
id [KEY]	String
contentType	String
isInline	Bool
lastModifiedDateTime	Datetime
name	String
size	Int
userId	String

ストアドプロシージャ

ストアドプロシージャはファンクションライクなインターフェースで、Microsoft Exchange の単純なSELECT/INSERT/UPDATE/DELETE 処理にとどまらずCloud の機能を拡張します。

ストアドプロシージャは、パラメータのリストを受け取り、目的の機能を実行し、プロシージャが成功したか失敗したかを示すとともにMicrosoft Exchange から関連するレスポンスデータを返します。

CData Cloud - Microsoft Exchange ストアドプロシージャ


Name	Description
AddAttachments	Add attachment(s) to a message.
DeleteAttachment	Delete attachment.
DismissEventReminder	Dismiss the reminder for an Event.
ForwardMail	Retrieve Forwarded Mail.
GetAdminConsentURL	Gets the admin consent URL that must be opened separately by an admin of a given domain to grant access to your application. Only needed when using custom OAuth credentials.
MoveMail	Move mail.
ReplyToMessage	Reply to a Message.
RespondToEvent	Respond to an Event.
SendMail	Send mail.
SnoozeEventReminder	Snooze the reminder for an Event.

AddAttachments

Add attachment(s) to a message.

Input


Name	Type	Required	Description
Id	String	False	The Id of the message to add the attachment to.
DestinationType	String	False	The destination object type where the attachment is being added. Allowed values are; Message or Event.
FileName	String	False	Name of the email attachment.
LocalFile	String	False	The file containing the content of the attachment
ContentBytes	String	False	Content of the attachment encoded to base 64.

Result Set Columns


Name	Type	Description
ContentBytes	String	Added Successfully - if the attachment content was added to the message/event.
Id	String	Id of the attachment that was added.
LastModifiedDateTime	Datetime	Last modified date time of attachment that was added.
Isinline	Boolean	Whether the attachment that was added is inline.
Name	String	Name of the attachment that was added.
Contenttype	String	Content-type of the attachment that was added.
Size	Int	Size of the attachment that was added.

DeleteAttachment

Delete attachment.

Input


Name	Type	Required	Description
MessageId	String	True	The email Id.
AttachmentID	String	True	Id of the attachment

Result Set Columns


Name	Type	Description
Id	String	Id of the message that was deleted.

DismissEventReminder

Dismiss the reminder for an Event.

Input


Name	Type	Required	Description
EventId	String	True	The event of the Id you are dismissing.

Result Set Columns


Name	Type	Description
Success	Boolean	If the request is sucessful.

ForwardMail

Retrieve Forwarded Mail.

Input


Name	Type	Required	Description
MessageId	String	True	Id of the email.
ToRecipients	String	True	A semicolon-separated list of recipient emails.
Comment	String	False	BodyContent on top of the original message.

Result Set Columns


Name	Type	Description
Success	Boolean	If the request is sucessful.

GetAdminConsentURL

Gets the admin consent URL that must be opened separately by an admin of a given domain to grant access to your application. Only needed when using custom OAuth credentials.

Input


Name	Type	Required	Description
CallbackUrl	String	False	The URL the user will be redirected to after authorizing your application. This value must match the Reply URL in the Azure AD app settings.
State	String	False	The same value for state that you sent when you requested the authorization code.
Scope	String	False	A space-separated list of scopes to request from the Admin. Please check the Microsoft Graph API documentation for a list of available permissions. デフォルト値はhttps://graph.microsoft.com/calendars.readwrite.Shared https://graph.microsoft.com/Contacts.ReadWrite https://graph.microsoft.com/Group.Read.All https://graph.microsoft.com/Group.ReadWrite.All https://graph.microsoft.com/User.ReadWrite.All https://graph.microsoft.com/Mail.ReadWrite.Shared https://graph.microsoft.com/Reports.Read.Allです。

Result Set Columns


Name	Type	Description
URL	String	The authorization URL, entered into a Web browser to obtain the verifier token and authorize your app.

MoveMail

Move mail.

Input


Name	Type	Required	Description
MessageId	String	True	The email Id.
DestinationId	String	True	Id of the destination folder where the email will be moved to.

Result Set Columns


Name	Type	Description
Id	String	Id of the message that was moved.

ReplyToMessage

Reply to a Message.

Input


Name	Type	Required	Description
MessageId	String	True	Id of the email.
Comment	String	False	BodyContent on top of the original message.
ToAll	String	False	Reply to all or not. デフォルト値はfalseです。

Result Set Columns


Name	Type	Description
Success	Boolean	If the request is sucessful.

RespondToEvent

Respond to an Event.

Input


Name	Type	Required	Description
EventId	String	True	The event of the Id you are responding to.
ResponseType	String	True	The type of the response to this event. Allowed values: Accept, Decline
SendResponse	String	False	True if a response is to be sent to the organizer; otherwise, false. Optional. Default is true. デフォルト値はtrueです。
Comment	String	False	Text included in the response. Optional.

Result Set Columns


Name	Type	Description
Success	Boolean	If the request is sucessful.

SendMail

Send mail.

Input


Name	Type	Required	Description
Id	String	False	The Id of the message to be sent (this is optional). The user can either use an existing email Id or send a new email by optionally filling the other fields.
Subject	String	False	The email subject.
Content	String	False	Email body content.
Attachments	String	False	The attachments. Specify File attachments in the following format: filename1,filecontent1;filename2,filecontent2. Each filecontent can be either base64 data, or the path of a local file with the @ character before it
FileName	String	False	Name of the email attachment.
LocalFile	String	False	The file containing the content of the attachment
ContentBytes	String	False	Content of the attachment encoded to base 64.
ToRecipients	String	False	The recipients. Specify recipients in the following order: [email protected];[email protected].
CcRecipients	String	False	The Cc: recipients for the message. Specify recipients in the following order: [email protected];[email protected].
BccRecipients	String	False	The Bcc: recipients for the message. Specify recipients in the following order: [email protected];[email protected].

Result Set Columns


Name	Type	Description
Success	Boolean	If the request is sucessful.

SnoozeEventReminder

Snooze the reminder for an Event.

Input


Name	Type	Required	Description
EventId	String	True	The event of the Id you are dismissing.
DateTime	String	False	The new date-time to postpone the event reminder to.
TimeZone	String	False	The TimeZone for the chosen date-time

Result Set Columns


Name	Type	Description
Success	Boolean	If the request is sucessful.

システムテーブル

このセクションで説明されているシステムテーブルをクエリして、スキーマ情報、データソース機能に関する情報、およびバッチ操作の統計にアクセスできます。

スキーマテーブル

以下のテーブルは、Microsoft Exchange のデータベースメタデータを返します。

sys_catalogs：利用可能なデータベースをリスト。
sys_schemas：利用可能なスキーマをリスト。
sys_tables：利用可能なテーブルおよびビューをリスト。
sys_tablecolumns：利用可能なテーブルおよびビューのカラムについて説明。
sys_procedures：利用可能なストアドプロシージャについて説明。
sys_procedureparameters：ストアドプロシージャパラメータについて説明。
sys_keycolumns：主キーおよび外部キーについて説明。
sys_indexes：利用可能なインデックスについて説明。

データソーステーブル

以下のテーブルは、データソースへの接続方法およびクエリ方法についての情報を返します。

sys_connection_props：利用可能な接続プロパティについての情報を返す。
sys_sqlinfo：Cloud がデータソースにオフロードできるSELECT クエリについて説明。

クエリ情報テーブル

次のテーブルは、データ変更クエリのクエリ統計を返します。

sys_identity：バッチ処理または単一の更新に関する情報を返す。

sys_catalogs

利用可能なデータベースをリストします。

次のクエリは、接続文字列で決定されるすべてのデータベースを取得します。

SELECT * FROM sys_catalogs

Columns


Name	Type	Description
CatalogName	String	データベース名。

sys_schemas

利用可能なスキーマをリストします。

次のクエリは、すべての利用可能なスキーマを取得します。

          SELECT * FROM sys_schemas

Columns


Name	Type	Description
CatalogName	String	データベース名。
SchemaName	String	スキーマ名。

sys_tables

利用可能なテーブルをリストします。

次のクエリは、利用可能なテーブルおよびビューを取得します。

          SELECT * FROM sys_tables

Columns


Name	Type	Description
CatalogName	String	テーブルまたはビューを含むデータベース。
SchemaName	String	テーブルまたはビューを含むスキーマ。
TableName	String	テーブル名またはビュー名。
TableType	String	テーブルの種類（テーブルまたはビュー）。
Description	String	テーブルまたはビューの説明。
IsUpdateable	Boolean	テーブルが更新可能かどうか。

sys_tablecolumns

利用可能なテーブルおよびビューのカラムについて説明します。

次のクエリは、Contacts テーブルのカラムとデータ型を返します。

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Contacts'

Columns


Name	Type	Description
CatalogName	String	テーブルまたはビューを含むデータベースの名前。
SchemaName	String	テーブルまたはビューを含むスキーマ。
TableName	String	カラムを含むテーブルまたはビューの名前。
ColumnName	String	カラム名。
DataTypeName	String	データ型の名前。
DataType	Int32	データ型を示す整数値。この値は、実行時に環境に基づいて決定されます。
Length	Int32	カラムのストレージサイズ。
DisplaySize	Int32	指定されたカラムの通常の最大幅（文字数）。
NumericPrecision	Int32	数値データの最大桁数。文字データおよび日時データの場合は、カラムの長さ（文字数）。
NumericScale	Int32	カラムのスケール（小数点以下の桁数）。
IsNullable	Boolean	カラムがNull を含められるかどうか。
Description	String	カラムの簡単な説明。
Ordinal	Int32	カラムのシーケンスナンバー。
IsAutoIncrement	String	カラムに固定増分値が割り当てられるかどうか。
IsGeneratedColumn	String	生成されたカラムであるかどうか。
IsHidden	Boolean	カラムが非表示かどうか。
IsArray	Boolean	カラムが配列かどうか。
IsReadOnly	Boolean	カラムが読み取り専用かどうか。
IsKey	Boolean	sys_tablecolumns から返されたフィールドがテーブルの主キーであるかどうか。

sys_procedures

利用可能なストアドプロシージャをリストします。

次のクエリは、利用可能なストアドプロシージャを取得します。

          SELECT * FROM sys_procedures

Columns


Name	Type	Description
CatalogName	String	ストアドプロシージャを含むデータベース。
SchemaName	String	ストアドプロシージャを含むスキーマ。
ProcedureName	String	ストアドプロシージャの名前。
Description	String	ストアドプロシージャの説明。
ProcedureType	String	PROCEDURE やFUNCTION などのプロシージャのタイプ。

sys_procedureparameters

ストアドプロシージャパラメータについて説明します。

次のクエリは、GetAttachment ストアドプロシージャのすべての入力パラメータについての情報を返します。

SELECT * FROM sys_procedureparameters WHERE ProcedureName='GetAttachment' AND Direction=1 OR Direction=2

Columns


Name	Type	Description
CatalogName	String	ストアドプロシージャを含むデータベースの名前。
SchemaName	String	ストアドプロシージャを含むスキーマの名前。
ProcedureName	String	パラメータを含むストアドプロシージャの名前。
ColumnName	String	ストアドプロシージャパラメータの名前。
Direction	Int32	パラメータのタイプに対応する整数値：input (1)。input/output (2)、またはoutput(4)。input/output タイプパラメータは、入力パラメータと出力パラメータの両方になれます。
DataTypeName	String	データ型の名前。
DataType	Int32	データ型を示す整数値。この値は、実行時に環境に基づいて決定されます。
Length	Int32	文字データの場合は、許可される文字数。数値データの場合は、許可される桁数。
NumericPrecision	Int32	数値データの場合は最大精度。文字データおよび日時データの場合は、カラムの長さ（文字数）。
NumericScale	Int32	数値データの小数点以下の桁数。
IsNullable	Boolean	パラメータがNull を含められるかどうか。
IsRequired	Boolean	プロシージャの実行にパラメータが必要かどうか。
IsArray	Boolean	パラメータが配列かどうか。
Description	String	パラメータの説明。
Ordinal	Int32	パラメータのインデックス。

sys_keycolumns

主キーおよび外部キーについて説明します。

次のクエリは、Contacts テーブルの主キーを取得します。

         SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Contacts'

Columns


Name	Type	Description
CatalogName	String	キーを含むデータベースの名前。
SchemaName	String	キーを含むスキーマの名前。
TableName	String	キーを含むテーブルの名前。
ColumnName	String	キーカラムの名前
IsKey	Boolean	カラムがTableName フィールドで参照されるテーブル内の主キーかどうか。
IsForeignKey	Boolean	カラムがTableName フィールドで参照される外部キーかどうか。
PrimaryKeyName	String	主キーの名前。
ForeignKeyName	String	外部キーの名前。
ReferencedCatalogName	String	主キーを含むデータベース。
ReferencedSchemaName	String	主キーを含むスキーマ。
ReferencedTableName	String	主キーを含むテーブル。
ReferencedColumnName	String	主キーのカラム名。

sys_foreignkeys

外部キーについて説明します。

次のクエリは、他のテーブルを参照するすべての外部キーを取得します。

         SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

カラム


名前	タイプ	説明
CatalogName	String	キーを含むデータベースの名前。
SchemaName	String	キーを含むスキーマの名前。
TableName	String	キーを含むテーブルの名前。
ColumnName	String	キーカラムの名前
PrimaryKeyName	String	主キーの名前。
ForeignKeyName	String	外部キーの名前。
ReferencedCatalogName	String	主キーを含むデータベース。
ReferencedSchemaName	String	主キーを含むスキーマ。
ReferencedTableName	String	主キーを含むテーブル。
ReferencedColumnName	String	主キーのカラム名。
ForeignKeyType	String	外部キーがインポート（他のテーブルを指す）キーかエクスポート（他のテーブルから参照される）キーかを指定します。

sys_primarykeys

主キーについて説明します。

次のクエリは、すべてのテーブルとビューから主キーを取得します。

         SELECT * FROM sys_primarykeys

Columns


Name	Type	Description
CatalogName	String	キーを含むデータベースの名前。
SchemaName	String	キーを含むスキーマの名前。
TableName	String	キーを含むテーブルの名前。
ColumnName	String	キーカラムの名前。
KeySeq	String	主キーのシーケンス番号。
KeyName	String	主キーの名前。

sys_indexes

利用可能なインデックスについて説明します。インデックスをフィルタリングすることで、より高速なクエリ応答時間でセレクティブクエリを記述できます。

次のクエリは、主キーでないすべてのインデックスを取得します。

          SELECT * FROM sys_indexes WHERE IsPrimary='false'

Columns


Name	Type	Description
CatalogName	String	インデックスを含むデータベースの名前。
SchemaName	String	インデックスを含むスキーマの名前。
TableName	String	インデックスを含むテーブルの名前。
IndexName	String	インデックス名。
ColumnName	String	インデックスに関連付けられたカラムの名前。
IsUnique	Boolean	インデックスが固有の場合はTrue。そうでない場合はFalse。
IsPrimary	Boolean	インデックスが主キーの場合はTrue。そうでない場合はFalse。
Type	Int16	インデックスタイプに対応する整数値：statistic (0)、clustered (1)、hashed (2)、またはother (3)。
SortOrder	String	並べ替え順序：A が昇順、D が降順。
OrdinalPosition	Int16	インデックスのカラムのシーケンスナンバー。

sys_connection_props

利用可能な接続プロパティと、接続文字列に設定されている接続プロパティに関する情報を返します。

このテーブルをクエリする際は、config 接続文字列を使用する必要があります。

jdbc:cdata:exchange:config:

この接続文字列を使用すると、有効な接続がなくてもこのテーブルをクエリできます。

次のクエリは、接続文字列に設定されている、あるいはデフォルト値で設定されているすべての接続プロパティを取得します。

SELECT * FROM sys_connection_props WHERE Value <> ''

Columns


Name	Type	Description
Name	String	接続プロパティ名。
ShortDescription	String	簡単な説明。
Type	String	接続プロパティのデータ型。
Default	String	明示的に設定されていない場合のデフォルト値。
Values	String	可能な値のカンマ区切りリスト。別な値が指定されていると、検証エラーがスローされます。
Value	String	設定した値またはあらかじめ設定されたデフォルト。
Required	Boolean	プロパティが接続に必要かどうか。
Category	String	接続プロパティのカテゴリ。
IsSessionProperty	String	プロパティが、現在の接続に関する情報を保存するために使用されるセッションプロパティかどうか。
Sensitivity	String	プロパティの機密度。これは、プロパティがロギングおよび認証フォームで難読化されているかどうかを通知します。
PropertyName	String	キャメルケースの短縮形の接続プロパティ名。
Ordinal	Int32	パラメータのインデックス。
CatOrdinal	Int32	パラメータカテゴリのインデックス。
Hierarchy	String	このプロパティと一緒に設定する必要がある、関連のある依存プロパティを表示します。
Visible	Boolean	プロパティが接続UI に表示されるかどうかを通知します。
ETC	String	プロパティに関するその他のさまざまな情報。

sys_sqlinfo

Cloud がデータソースにオフロードできるSELECT クエリ処理について説明します。

SQL 構文の詳細については、SQL 準拠を参照してください。

データソースのSELECT 機能

以下はSQL 機能のサンプルデータセットです。 SELECT 機能のいくつかの側面がサポートされている場合には、カンマ区切りのリストで返されます。サポートされていない場合、カラムにはNO が入ります。


名前	説明	有効な値
AGGREGATE_FUNCTIONS	サポートされている集計関数。	AVG, COUNT, MAX, MIN, SUM, DISTINCT
COUNT	COUNT 関数がサポートされているかどうか。	YES, NO
IDENTIFIER_QUOTE_OPEN_CHAR	識別子をエスケープするための開始文字。	[
IDENTIFIER_QUOTE_CLOSE_CHAR	識別子をエスケープするための終了文字。	]
SUPPORTED_OPERATORS	サポートされているSQL 演算子。	=, >, <, >=, <=, <>, !=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, AND, OR
GROUP_BY	GROUP BY がサポートされているかどうか。サポートされている場合、どのレベルでサポートされているか。	NO, NO_RELATION, EQUALS_SELECT, SQL_GB_COLLATE
OJ_CAPABILITIES	サポートされている外部結合の種類。	NO, LEFT, RIGHT, FULL, INNER, NOT_ORDERED, ALL_COMPARISON_OPS
OUTER_JOINS	外部結合がサポートされているかどうか。	YES, NO
SUBQUERIES	サブクエリがサポートされているかどうか。サポートされていれば、どのレベルでサポートされているか。	NO, COMPARISON, EXISTS, IN, CORRELATED_SUBQUERIES, QUANTIFIED
STRING_FUNCTIONS	サポートされている文字列関数。	LENGTH, CHAR, LOCATE, REPLACE, SUBSTRING, RTRIM, LTRIM, RIGHT, LEFT, UCASE, SPACE, SOUNDEX, LCASE, CONCAT, ASCII, REPEAT, OCTET, BIT, POSITION, INSERT, TRIM, UPPER, REGEXP, LOWER, DIFFERENCE, CHARACTER, SUBSTR, STR, REVERSE, PLAN, UUIDTOSTR, TRANSLATE, TRAILING, TO, STUFF, STRTOUUID, STRING, SPLIT, SORTKEY, SIMILAR, REPLICATE, PATINDEX, LPAD, LEN, LEADING, KEY, INSTR, INSERTSTR, HTML, GRAPHICAL, CONVERT, COLLATION, CHARINDEX, BYTE
NUMERIC_FUNCTIONS	サポートされている数値関数。	ABS, ACOS, ASIN, ATAN, ATAN2, CEILING, COS, COT, EXP, FLOOR, LOG, MOD, SIGN, SIN, SQRT, TAN, PI, RAND, DEGREES, LOG10, POWER, RADIANS, ROUND, TRUNCATE
TIMEDATE_FUNCTIONS	サポートされている日付および時刻関数。	NOW, CURDATE, DAYOFMONTH, DAYOFWEEK, DAYOFYEAR, MONTH, QUARTER, WEEK, YEAR, CURTIME, HOUR, MINUTE, SECOND, TIMESTAMPADD, TIMESTAMPDIFF, DAYNAME, MONTHNAME, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, EXTRACT
REPLICATION_SKIP_TABLES	レプリケーション中にスキップされたテーブルを示します。
REPLICATION_TIMECHECK_COLUMNS	レプリケーション中に更新判断のカラムとして使用するかどうかを、（指定された順に）チェックするカラムのリストを含む文字列の配列。
IDENTIFIER_PATTERN	識別子としてどの文字列が有効かを示す文字列値。
SUPPORT_TRANSACTION	プロバイダーが、コミットやロールバックなどのトランザクションをサポートしているかどうかを示します。	YES, NO
DIALECT	使用するSQL ダイアレクトを示します。
KEY_PROPERTIES	Uniform データベースを特定するプロパティを示します。
SUPPORTS_MULTIPLE_SCHEMAS	プロバイダー用に複数のスキームが存在するかどうかを示します。	YES, NO
SUPPORTS_MULTIPLE_CATALOGS	プロバイダー用に複数のカタログが存在するかどうかを示します。	YES, NO
DATASYNCVERSION	このドライバーにアクセスするために必要な、CData Sync のバージョン。	Standard, Starter, Professional, Enterprise
DATASYNCCATEGORY	このドライバーのCData Sync カテゴリ。	Source, Destination, Cloud Destination
SUPPORTSENHANCEDSQL	API で提供されている以上の、追加SQL 機能がサポートされているかどうか。	TRUE, FALSE
SUPPORTS_BATCH_OPERATIONS	バッチ操作がサポートされているかどうか。	YES, NO
SQL_CAP	このドライバーでサポートされているすべてのSQL 機能。	SELECT, INSERT, DELETE, UPDATE, TRANSACTIONS, ORDERBY, OAUTH, ASSIGNEDID, LIMIT, LIKE, BULKINSERT, COUNT, BULKDELETE, BULKUPDATE, GROUPBY, HAVING, AGGS, OFFSET, REPLICATE, COUNTDISTINCT, JOINS, DROP, CREATE, DISTINCT, INNERJOINS, SUBQUERIES, ALTER, MULTIPLESCHEMAS, GROUPBYNORELATION, OUTERJOINS, UNIONALL, UNION, UPSERT, GETDELETED, CROSSJOINS, GROUPBYCOLLATE, MULTIPLECATS, FULLOUTERJOIN, MERGE, JSONEXTRACT, BULKUPSERT, SUM, SUBQUERIESFULL, MIN, MAX, JOINSFULL, XMLEXTRACT, AVG, MULTISTATEMENTS, FOREIGNKEYS, CASE, LEFTJOINS, COMMAJOINS, WITH, LITERALS, RENAME, NESTEDTABLES, EXECUTE, BATCH, BASIC, INDEX
PREFERRED_CACHE_OPTIONS	使用したいcacheOptions を指定する文字列値。
ENABLE_EF_ADVANCED_QUERY	ドライバーがEntity Framework の高度なクエリをサポートしているかどうかを示します。サポートしていなければ、クエリはクライアントサイドで処理されます。	YES, NO
PSEUDO_COLUMNS	利用可能な疑似カラムを示す文字列の配列。
MERGE_ALWAYS	値がtrue であれば、CData Sync 内でMerge Model が強制的に実行されます。	TRUE, FALSE
REPLICATION_MIN_DATE_QUERY	レプリケート開始日時を返すSELECT クエリ。
REPLICATION_MIN_FUNCTION	サーバーサイドでmin を実行するために使用する式名を、プロバイダーが指定できるようになります。
REPLICATION_START_DATE	レプリケート開始日を、プロバイダーが指定できるようになります。
REPLICATION_MAX_DATE_QUERY	レプリケート終了日時を返すSELECT クエリ。
REPLICATION_MAX_FUNCTION	サーバーサイドでmax を実行するために使用する式名を、プロバイダーが指定できるようになります。
IGNORE_INTERVALS_ON_INITIAL_REPLICATE	初回のレプリケートで、レプリケートをチャンクに分割しないテーブルのリスト。
CHECKCACHE_USE_PARENTID	CheckCache 構文を親キーカラムに対して実行するかどうかを示します。	TRUE, FALSE
CREATE_SCHEMA_PROCEDURES	スキーマファイルの生成に使用できる、ストアドプロシージャを示します。

次のクエリは、WHERE 句で使用できる演算子を取得します。

SELECT * FROM sys_sqlinfo WHERE Name = 'SUPPORTED_OPERATORS'

WHERE 句では、個々のテーブルの制限や要件が異なる場合がありますので注意してください。詳しくは、データモデルセクションを参照してください。

Columns


Name	Type	Description
NAME	String	SQL 構文のコンポーネント、またはサーバー上で処理できる機能。
VALUE	String	サポートされるSQL またはSQL 構文の詳細。

sys_identity

試行された変更に関する情報を返します。

次のクエリは、バッチ処理で変更された行のId を取得します。

         SELECT * FROM sys_identity

Columns


Name	Type	Description
Id	String	データ変更処理から返された、データベース生成Id。
Batch	String	バッチの識別子。1 は単一処理。
Operation	String	バッチ内の処理の結果：INSERTED、UPDATED、またはDELETED。
Message	String	SUCCESS、またはバッチ内の更新が失敗した場合のエラーメッセージ。

接続文字列オプション

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

Authentication

プロパティ	説明
Platform	Exchange サーバーと関連したプラットフォーム。
Schema	Microsoft Exchange スキーマを指定します。
AuthScheme	認証で使用されるスキーム。許容されるエントリーはNTLM、Basic、Digest、None、Negotiate、OAuth、AzureAD、AzureServicePrincipal、AzureMSI です。
Server	接続するExchange サーバーのアドレス。
User	Exchange サイトへの認証を行っているユーザー。
Password	Exchange サイトへの認証に使われるパスワード。

Azure Authentication

プロパティ	説明
AzureTenant	データにアクセスするために使用されるMicrosoft Online テナント。指定しない場合は、デフォルトのテナントが使用されます。

OAuth

プロパティ	説明
OAuthClientId	OAuth 認証サーバーを使用してアプリケーションを登録する場合に割り当てられたクライアントId。
OAuthClientSecret	OAuth 認証サーバーにアプリケーションを登録する場合に割り当てられたクライアントシークレット。
OAuthGrantType	OAuth フローのグラント種別。
UserId	Specify this UserId in order to access Outlook resources for a specific user. Required when OAuthGrantType is set to 'CLIENT'.

JWT OAuth

プロパティ	説明
OAuthJWTCert	JWT 証明書のストア。
OAuthJWTCertType	JWT 証明書を格納するキーストアの種類。
OAuthJWTCertPassword	OAuth JWT 証明書のパスワード。
OAuthJWTCertSubject	OAuth JWT 証明書のサブジェクト。

SSL

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

Logging

プロパティ	説明
Verbosity	ログファイルの記述をどの程度の詳細さで記載するかを決定するverbosity レベル。

Schema

プロパティ	説明
BrowsableSchemas	このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。

Miscellaneous

プロパティ	説明
AlwaysRequestTableDependencies	Control whether you want to always retrieve Table Dependencies (Foreign Keys). Setting this to TRUE might slow down queries and increase amount of calls made.
BodyType	The BodyType element identifies how the body text is formatted in the response. The possible options are: Best - The response will return the richest available content of body text, HTML - The response will return an item body as HTML, Text - The response will return an item body as plain text. The default is set to Best.
CustomHeaders	ユーザーが決定したその他のヘッダー（オプション）。
DirectoryRetrievalDepth	Depth level of folder to query Folders and Items.
DisableServerSideFiltering	Control whether you want to disable server-side filtering. By default this property is set to False, and server-side filtering is attempted for all columns/tables.
GroupId	Specify this GroupId in order to access the OneNote documents for this group.
ImpersonationType	Exchange サイトにリクエストを送信する際の偽装を使うための識別子のタイプ。
ImpersonationUser	Exchange サイトにリクエストを送信する際の偽装ユーザー。
IncludeContent	A boolean indicating if additional content should be retrieved.
MaxRows	クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。
Pagesize	Microsoft Exchange から返されるページあたりの結果の最大数。
PseudoColumns	このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
Timeout	タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。

Authentication

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

プロパティ	説明
Platform	Exchange サーバーと関連したプラットフォーム。
Schema	Microsoft Exchange スキーマを指定します。
AuthScheme	認証で使用されるスキーム。許容されるエントリーはNTLM、Basic、Digest、None、Negotiate、OAuth、AzureAD、AzureServicePrincipal、AzureMSI です。
Server	接続するExchange サーバーのアドレス。
User	Exchange サイトへの認証を行っているユーザー。
Password	Exchange サイトへの認証に使われるパスワード。

解説

このフィールドは、Password およびUser とともに、サーバーに対して認証をするために使われます。デフォルトオプションはBasic です。次のオプションを使って、認証スキームを選択してください。

NTLM：認証にWindows クレデンシャルを使う場合に設定。
Basic：HTTP Basic 認証を使う場合に設定。
Digest:HTTP Digest 認証を使う場合に設定。
Negotiate：AuthScheme がNegotiate に設定された場合、Cloud は認証メカニズムをサーバーとネゴシエートします。Kerberos 認証を使う場合にAuthScheme をNegotiate に設定します。
OAuth：OAuth 2.0 は、Exchange Online プラットフォームでのみサポートされています。
AzureAD：Azure Active Directory OAuth 認証を実行する場合に設定。この認証スキームは、Exchange_Online Platform にのみ適用されます。
AzureMSI：Azure VM で実行しているときにマネージドサービスID のクレデンシャルを自動的に取得する場合に設定します。この認証スキームは、Exchange_Online Platform にのみ適用されます。
AzureServicePrincipal：Azure サービスプリンシパルとして認証する場合に設定。この認証スキームは、Exchange_Online Platform にのみ適用されます。
AzureServicePrincipalCert：Azure サービスプリンシパル証明書として認証する場合に設定。この認証スキームは、Exchange_Online Platform にのみ適用されます。

Azure Authentication

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

プロパティ	説明
AzureTenant	データにアクセスするために使用されるMicrosoft Online テナント。指定しない場合は、デフォルトのテナントが使用されます。

AzureTenant

データにアクセスするために使用されるMicrosoft Online テナント。指定しない場合は、デフォルトのテナントが使用されます。

データ型

string

デフォルト値

""

解説

データにアクセスするために使用されるMicrosoft Online テナント。例えば、contoso.onmicrosoft.com です。あるいは、テナントId を指定します。この値は［Azure ポータル］->［Azure Active Directory］->［プロパティ］のディレクトリId です。

通常、Tenant を指定する必要はありません。OAuthGrantType をCODE（デフォルト）に設定している場合は、Microsoft が自動的に決定します。ただし、ユーザーがマルチテナントに所属している場合は失敗する可能性があります。例えば、ドメインA の管理者がドメインB のユーザーをゲストユーザーとして招待した場合。ユーザーは両方のテナントに属していることになります。 Tenant を指定するのはグッドプラクティスですが、一般的には指定しなくてもうまく動作するはずです。

OAuthGrantType をCLIENT に設定する場合は、AzureTenant が必須です。クライアント資格情報を使用する場合、ユーザーコンテキストはありません。資格情報は、アプリ自体のコンテキストから取得されます。Microsoft ではTenant を指定せずにクライアント資格情報を取得することを許容していますが、使用する特定のテナントを選択する可能性ははるかに低くなっています。このため、接続するドメインに適用される資格情報を確実に取得するために、すべてのクライアント資格情報接続に対してAzureTenant を明示的に指定する必要があります。

OAuth

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

プロパティ	説明
OAuthClientId	OAuth 認証サーバーを使用してアプリケーションを登録する場合に割り当てられたクライアントId。
OAuthClientSecret	OAuth 認証サーバーにアプリケーションを登録する場合に割り当てられたクライアントシークレット。
OAuthGrantType	OAuth フローのグラント種別。
UserId	Specify this UserId in order to access Outlook resources for a specific user. Required when OAuthGrantType is set to 'CLIENT'.

解説

Specify this UserId in order to access Outlook resources for a specific user. Required when OAuthGrantType is set to 'CLIENT'.

JWT OAuth

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

プロパティ	説明
OAuthJWTCert	JWT 証明書のストア。
OAuthJWTCertType	JWT 証明書を格納するキーストアの種類。
OAuthJWTCertPassword	OAuth JWT 証明書のパスワード。
OAuthJWTCertSubject	OAuth JWT 証明書のサブジェクト。

OAuthJWTCert

JWT 証明書のストア。

データ型

string

デフォルト値

""

解説

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

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

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

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

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


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

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

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

OAuthJWTCertType

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

データ型

string

デフォルト値

"PEMKEY_BLOB"

解説

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


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 形式の証明書を含む文字列の名前です。

OAuthJWTCertPassword

OAuth JWT 証明書のパスワード。

データ型

string

デフォルト値

""

解説

証明書ストアでパスワードが必要である場合、このプロパティを使用してパスワードを指定し、証明書ストアにアクセスできます。

OAuthJWTCertSubject

OAuth JWT 証明書のサブジェクト。

データ型

string

デフォルト値

"*"

解説

証明書のサブジェクトは、証明書をロードするときにストア内の証明書を検索するために使用されます。

完全に一致するものが見つからない場合、ストアはプロパティの値を含むサブジェクトを検索します。

それでも一致するものが見つからない場合、プロパティは空白で設定され、証明書は選択されません。

"*" に設定すると、証明書ストアの1番目の証明書が選択されます。

証明書のサブジェクトは識別の名前フィールドおよび値のカンマ区切りのリストです。例えば、"CN=www.server.com, OU=test, C=US, [email protected]"。共通のフィールドとその説明は以下のとおりです。


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

フィールド値にカンマが含まれている場合は、それを引用符で囲む必要があります。

SSL

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

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

SSLServerCert

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

データ型

string

デフォルト値

""

解説

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

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

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

Logging

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

プロパティ	説明
Verbosity	ログファイルの記述をどの程度の詳細さで記載するかを決定するverbosity レベル。

Verbosity

ログファイルの記述をどの程度の詳細さで記載するかを決定するverbosity レベル。

データ型

string

デフォルト値

"1"

解説

Verbosity レベルは、Cloud がLogfile にどの程度の詳細さで記載するかを決定します。1 から5 までのVerbosity レベルがサポートされています。より詳しい説明は、ログページに記載されています。

Schema

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

プロパティ	説明
BrowsableSchemas	このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。

BrowsableSchemas

このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。

データ型

string

デフォルト値

""

解説

スキーマをデータベースからリストすると、負荷がかかる可能性があります。接続文字列でスキーマのリストを提供すると、パフォーマンスが向上します。

Miscellaneous

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

プロパティ	説明
AlwaysRequestTableDependencies	Control whether you want to always retrieve Table Dependencies (Foreign Keys). Setting this to TRUE might slow down queries and increase amount of calls made.
BodyType	The BodyType element identifies how the body text is formatted in the response. The possible options are: Best - The response will return the richest available content of body text, HTML - The response will return an item body as HTML, Text - The response will return an item body as plain text. The default is set to Best.
CustomHeaders	ユーザーが決定したその他のヘッダー（オプション）。
DirectoryRetrievalDepth	Depth level of folder to query Folders and Items.
DisableServerSideFiltering	Control whether you want to disable server-side filtering. By default this property is set to False, and server-side filtering is attempted for all columns/tables.
GroupId	Specify this GroupId in order to access the OneNote documents for this group.
ImpersonationType	Exchange サイトにリクエストを送信する際の偽装を使うための識別子のタイプ。
ImpersonationUser	Exchange サイトにリクエストを送信する際の偽装ユーザー。
IncludeContent	A boolean indicating if additional content should be retrieved.
MaxRows	クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。
Pagesize	Microsoft Exchange から返されるページあたりの結果の最大数。
PseudoColumns	このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
Timeout	タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。

解説

このプロパティは、他のプロパティ（ContentType、From など）から作成されたHTTP リクエストヘッダーに追加するヘッダーの文字列に設定できます。

Cloud

Microsoft Exchange - CData Cloud

概要

主要機能

はじめに

Microsoft Exchange への接続

CData Cloud サービスからデータにアクセス

接続の確立

Microsoft Exchange への接続

Exchange Online

Microsoft Exchange への認証

OAuth

Azure AD

Azure サービスプリンシパル

クライアントシークレットによる認証

Managed Service Identity (MSI)

User-Managed Identities

Kerberos

Azure サービスプリンシパルの使用

Azure サービスプリンシパル

管理者の同意

クライアントクレデンシャル

Kerberos の使用

Kerberos

Kerberos チケットの取得

クロスレルム認証の有効化

Exchange Online の管理タスク

UserId カラム

Exchange データの選択

FindItem vs. GetItem

パブリック、およびカスタムフォルダ

パブリックフォルダとカスタムフォルダでのアイテムの作成

パブリック、およびカスタムフォルダへの挿入

パブリックフォルダとカスタムフォルダでのアイテムの更新および削除

パブリックおよびカスタムフォルダのItem の更新および削除

データアクセスのファインチューニング

ユーザーの偽装

SSL の設定

SSL 設定のカスタマイズ

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

Firewall またはProxy 経由の接続

HTTP プロキシ

その他のプロキシ

データモデル

概要

主要機能

EWS データモデル

MSGraph データモデル

EWS データモデル

テーブル

CData Cloud - Microsoft Exchange テーブル

Calendar

テーブル固有の情報

Update およびDelete

定期イベントを選択

Columns

Pseudo-Columns

Calendar_OptionalAttendees

テーブル固有の情報

Update およびDelete

挿入

Columns

Pseudo-Columns

Calendar_RequiredAttendees

テーブル固有の情報

挿入ステートメント

Columns

Pseudo-Columns

Contacts

テーブル固有の情報

Update およびDelete

Columns

Pseudo-Columns

DeletedItems

テーブル固有の情報

Select Emails from DeletedItems Subfolders

Update およびDelete

Columns

Pseudo-Columns

Drafts