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

Microsoft Teams への接続

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

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

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

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

Microsoft Teams への接続

Microsoft Teams は、以下の認証メソッドをサポートします。

Entra ID（Azure AD）

Note：Microsoft はAzure AD をEntra ID にリブランドしました。ユーザーがEntra ID 管理サイトを操作する必要があるトピックでは、Microsoft が使用している名称と同じものを使用します。ただし、名前または値が"Azure AD" を参照しているCData 接続プロパティは、依然として存在します。

Microsoft Entra ID は、マルチテナント型のクラウドベースのID およびアクセス管理プラットフォームです。 OAuth ベースの認証フローに対応しており、ドライバーによるMicrosoft Teams エンドポイントへのセキュアなアクセスを実現します。

Web アプリケーションを介したEntra ID への認証には、必ずはじめにカスタムOAuth アプリケーションを作成して登録する必要があります。 これにより、アプリケーションは独自のリダイレクトURI を定義し、クレデンシャルのスコープを管理し、組織固有のセキュリティポリシーに準拠することができるようになります。

カスタムOAuth アプリケーションの作成および登録方法の詳細については、Entra ID（Azure AD）アプリケーションの作成 を参照してください。

AuthScheme をAzureAD に設定した後の認証手順は、環境によって異なります。 デスクトップアプリケーション、Web ベースのワークフロー、またはヘッドレスシステムから接続する方法の詳細については、以下のセクションを参照してください。

Azure サービスプリンシパル

Note：Microsoft はAzure AD をEntra ID にリブランドしました。ユーザーがEntra ID 管理サイトを操作する必要があるトピックでは、Microsoft が使用している名称と同じものを使用します。ただし、名前または値が"Azure AD" を参照しているCData 接続プロパティは、依然として存在します。

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

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

Managed Service Identity (MSI)

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

User-Managed Identities

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

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

Entra ID（Azure AD）アプリケーションの作成

Note：Microsoft はAzure AD をEntra ID にリブランドしました。ユーザーがEntra ID 管理サイトを操作する必要があるトピックでは、Microsoft が使用している名称と同じものを使用します。ただし、名前または値が"Azure AD" を参照しているCData 接続プロパティは、依然として存在します。

Microsoft Teams は、Microsoft Entra ID を使用したOAuth ベースの認証をサポートします。 Web アプリケーション経由で接続してEntra ID で認証したい場合は、以下に説明するように、まずEntra 管理センターでカスタムOAuth アプリケーションを登録する必要があります。

デスクトップアプリケーションまたはヘッドレスマシン経由で接続する場合は、CData ブランドを使用したMicrosoft Teams の組み込みアプリケーション認証情報を使用して認証できます。 ただし、カスタムOAuth アプリケーションもデスクトップおよびヘッドレス認証フローに対応しており、本番環境への導入や厳格なポリシー制御が求められる環境では、こちらの方が望ましい場合があります。

アプリケーションの登録

Microsoft Entra ID でOAuth アプリケーションを登録するには、次の手順に従います。

1. https://portal.azure.com に移動します。
2. 左側のナビゲーションペインでMicrosoft Entra ID ->アプリの登録を選択します。
3. 新規登録をクリックします。
4. アプリケーションの名前を入力します。
5. このアプリケーションがサポートすべきアカウントの種類を指定します。
   • 個人使用のアプリケーションの場合は、この組織ディレクトリ内のアカウントのみを選択します。
   • 配布アプリケーションの場合は、マルチテナントオプションのいずれかを選択します。

   Note：この組織ディレクトリ内のアカウントのみを選択する場合は、 CData Cloud への接続の際にAzureTenant をテナントのId（GUID または検証済みドメイン）に設定する必要があります。 そうでない場合、認証は失敗します。

6. Select a platform をWeb に設定し、リダイレクトURI をhttp://localhost:33333（デフォルト）、またはデプロイに適した別のURI に設定してください。 カスタムのリダイレクトURI を使用する場合は、CallbackURL 接続プロパティを設定してください。その際、このURI と正確に一致するように設定する必要があります。
7. 登録をクリックします。アプリケーション管理画面が開きます。 後で使用するために、表示される値を控えておきます。
   • アプリケーション（クライアント）ID は、OAuthClientId に使用されます。
   • ディレクトリ（テナント）ID は、AzureTenant に使用されます。
8. 証明書とシークレットに移動します。新しいクライアントシークレットをクリックし、希望する有効期限を設定して、生成された値を保存します。 この値は一度しか表示されないため、OAuthClientSecret で使用するために記録しておいてください。

9. Select Required Permissions and then click Add. Under Select an API, select the Microsoft Graph and specifically select the following permissions:

   • Group.ReadWrite.All
   • AppCatalog.ReadWrite.All
   • User.Read.All
   • ChannelMessage.Read.All
   • Chat.Read
   • Chat.ReadBasic
   • Chat.ReadWrite
   • Group.Read.All
   • Presence.Read.All

10. 確認のため、アクセス許可の追加をクリックします。

Entra ID（Azure AD）アプリケーションの作成

Note：Microsoft はAzure AD をEntra ID にリブランドしました。ユーザーがEntra ID 管理サイトを操作する必要があるトピックでは、Microsoft が使用している名称と同じものを使用します。ただし、名前または値が"Azure AD" を参照しているCData 接続プロパティは、依然として存在します。

Microsoft Teams は、Microsoft Entra ID を使用したOAuth ベースの認証をサポートします。 Web アプリケーション経由で接続してEntra ID で認証したい場合は、以下に説明するように、まずEntra 管理センターでカスタムOAuth アプリケーションを登録する必要があります。

デスクトップアプリケーションまたはヘッドレスマシン経由で接続する場合は、CData ブランドを使用したMicrosoft Teams の組み込みアプリケーション認証情報を使用して認証できます。 ただし、カスタムOAuth アプリケーションもデスクトップおよびヘッドレス認証フローに対応しており、本番環境への導入や厳格なポリシー制御が求められる環境では、こちらの方が望ましい場合があります。

アプリケーションの登録

Microsoft Entra ID でOAuth アプリケーションを登録するには、次の手順に従います。

1. https://portal.azure.com に移動します。
2. 左側のナビゲーションペインでMicrosoft Entra ID ->アプリの登録を選択します。
3. 新規登録をクリックします。
4. アプリケーションの名前を入力します。
5. このアプリケーションがサポートすべきアカウントの種類を指定します。
   • 個人使用のアプリケーションの場合は、この組織ディレクトリ内のアカウントのみを選択します。
   • 配布アプリケーションの場合は、マルチテナントオプションのいずれかを選択します。

   Note：この組織ディレクトリ内のアカウントのみを選択する場合は、 CData Cloud への接続の際にAzureTenant をテナントのId（GUID または検証済みドメイン）に設定する必要があります。 そうでない場合、認証は失敗します。

6. Select a platform をWeb に設定し、リダイレクトURI をhttp://localhost:33333（デフォルト）、またはデプロイに適した別のURI に設定してください。 カスタムのリダイレクトURI を使用する場合は、CallbackURL 接続プロパティを設定してください。その際、このURI と正確に一致するように設定する必要があります。
7. 登録をクリックします。アプリケーション管理画面が開きます。 後で使用するために、表示される値を控えておきます。
   • アプリケーション（クライアント）ID は、OAuthClientId に使用されます。
   • ディレクトリ（テナント）ID は、AzureTenant に使用されます。
8. 証明書とシークレットに移動します。新しいクライアントシークレットをクリックし、希望する有効期限を設定して、生成された値を保存します。 この値は一度しか表示されないため、OAuthClientSecret で使用するために記録しておいてください。

9. Select Required Permissions and then click Add. Under Select an API, select the Microsoft Graph and specifically select the following permissions:

   • Group.ReadWrite.All
   • AppCatalog.ReadWrite.All
   • User.Read.All
   • ChannelMessage.Read.All
   • Chat.Read
   • Chat.ReadBasic
   • Chat.ReadWrite
   • Group.Read.All
   • Presence.Read.All

10. 確認のため、アクセス許可の追加をクリックします。

Entra ID（Azure AD）でのサービスプリンシパルアプリの作成

Note：Microsoft はAzure AD をEntra ID にリブランドしました。ユーザーがEntra ID 管理サイトを操作する必要があるトピックでは、Microsoft が使用している名称と同じものを使用します。ただし、名前または値が"Azure AD" を参照しているCData 接続プロパティは、依然として存在します。

Microsoft Teams はサービスプリンシパルベースの認証をサポートしており、これはロールベースです。 つまり、サービスプリンシパルの権限は、割り当てられたロールによって決まります。 ロールは、サービスプリンシパルがアクセスできるリソースと実行可能な操作を指定します。

Microsoft Teams に対してサービスプリンシパルを使用して認証を行いたい場合は、Microsoft Entra ID でカスタムアプリケーションを作成する必要があります。

サービスプリンシパル認証を有効にするには：

• テナント内でアプリケーションの登録とロールの割り当てを行う権限があることを確認します。
• Entra 管理センターで新しいアプリケーションを登録し、認証情報とアクセス許可を構成してください。

アプリケーションの登録

1. https://portal.azure.com に移動します。
2. 左側のナビゲーションペインでMicrosoft Entra ID ->アプリの登録を選択します。
3. 新規登録をクリックします。
4. アプリケーションの名前を入力します。
5. 希望するテナント設定を選択します。このカスタムアプリケーションはサービスプリンシパル用であるため、任意のMicrosoft Entra ID テナント - マルチテナントを選択します。

6. 登録をクリックします。アプリケーション管理画面が開きます。
7. OAuthClientId としてアプリケーション（クライアント）ID の値、AzureTenant としてディレクトリ（テナント）ID の値を控えておきます。

8. 証明書とシークレットセクションに移動して、アプリケーションの認証タイプを定義します。証明書（推奨）とクライアントシークレットの2種類の認証方法が利用可能です。
   • 証明書による認証： 証明書とシークレットで証明書のアップロードを選択し、ローカルマシンから証明書をアップロードします。 自己署名証明書の作成についての詳細は、自己署名証明書の作成 を参照してください。
   • 新しいクライアントシークレットの作成： 証明書とシークレットで新しいクライアントシークレットを選択し、有効期限を指定します。クライアントシークレットが保存されると、Microsoft Teams はキーの値を表示します。この値は一度しか表示されないので、後で使用するために記録しておきます。この値をOAuthClientSecret に使用します。

9. 認証に移動し、アクセストークンオプションを選択します。

10. Select Required Permissions and then click Add. Under Select an API, select the Microsoft Graph and specifically select the following permissions:

    • Group.ReadWrite.All
    • AppCatalog.ReadWrite.All
    • User.Read.All
    • ChannelMessage.Read.All
    • Chat.Read
    • Chat.ReadBasic
    • Chat.ReadWrite
    • Group.Read.All
    • Presence.Read.All

11. 変更を保存します。
12. 管理者の同意が必要なアクセス許可（［アプリケーションの許可］など）を指定した場合は、API のアクセス許可ページで現在のテナントから付与することができます。

管理者の同意の付与

カスタムアプリケーションの中には、Microsoft Entra ID テナント内で操作するために管理者権限が必要なものがあります。 これは特に、サインインしているユーザーなしでアプリケーションを実行できるアプリケーションの許可を使用するアプリケーションに当てはまります。 新しいアプリケーションを作成する際に、「管理者の同意が必要」とマークされた関連するアクセス許可を追加することで、管理者の同意を与えることができます。 管理者の同意は、認証フローでクライアント資格情報を使用する場合にも必要です。

これらのアクセス許可は、管理者によって付与される必要があります。管理者の同意を付与するには：

1. 管理者アカウントでhttps://portal.azure.com にログインします。
2. Microsoft Entra ID ->アプリの登録に移動し、登録済みのアプリケーションを選択します。
3. API のアクセス許可に移動します。
4. アプリケーションの許可にリストされている許可を確認します。ユースケースに必要なAPI スコープが含まれていることを確認してください。
5. 管理者の同意を与えますをクリックして、要求された許可を承認します。

これで、アプリケーションが作成されたテナントにアクセス権限が付与されます。

クライアント資格情報の同意

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

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

1. https://portal.azure.com にログインします。
2. 前述のように、カスタムOAuth アプリケーションを作成します。
3. アプリの登録に移動します。
4. 作成したアプリケーションを探し、API のアクセス許可を開きます。
5. Microsoft Graph アクセス許可を選択します。アクセス許可には2つの異なるアクセス許可セットがあります。委任されたアクセス許可とアプリケーションの許可です。
6. サービスプリンシパルで使用する場合は、アプリケーションの許可を指定します。
7. インテグレーションに必要なアクセス許可を選択します。

Entra ID（Azure AD）でのサービスプリンシパルアプリの作成

Note：Microsoft はAzure AD をEntra ID にリブランドしました。ユーザーがEntra ID 管理サイトを操作する必要があるトピックでは、Microsoft が使用している名称と同じものを使用します。ただし、名前または値が"Azure AD" を参照しているCData 接続プロパティは、依然として存在します。

Microsoft Teams はサービスプリンシパルベースの認証をサポートしており、これはロールベースです。 つまり、サービスプリンシパルの権限は、割り当てられたロールによって決まります。 ロールは、サービスプリンシパルがアクセスできるリソースと実行可能な操作を指定します。

Microsoft Teams に対してサービスプリンシパルを使用して認証を行いたい場合は、Microsoft Entra ID でカスタムアプリケーションを作成する必要があります。

サービスプリンシパル認証を有効にするには：

• テナント内でアプリケーションの登録とロールの割り当てを行う権限があることを確認します。
• Entra 管理センターで新しいアプリケーションを登録し、認証情報とアクセス許可を構成してください。

アプリケーションの登録

1. https://portal.azure.com に移動します。
2. 左側のナビゲーションペインでMicrosoft Entra ID ->アプリの登録を選択します。
3. 新規登録をクリックします。
4. アプリケーションの名前を入力します。
5. 希望するテナント設定を選択します。このカスタムアプリケーションはサービスプリンシパル用であるため、任意のMicrosoft Entra ID テナント - マルチテナントを選択します。

6. 登録をクリックします。アプリケーション管理画面が開きます。
7. OAuthClientId としてアプリケーション（クライアント）ID の値、AzureTenant としてディレクトリ（テナント）ID の値を控えておきます。

8. 証明書とシークレットセクションに移動して、アプリケーションの認証タイプを定義します。証明書（推奨）とクライアントシークレットの2種類の認証方法が利用可能です。
   • 証明書による認証： 証明書とシークレットで証明書のアップロードを選択し、ローカルマシンから証明書をアップロードします。 自己署名証明書の作成についての詳細は、自己署名証明書の作成 を参照してください。
   • 新しいクライアントシークレットの作成： 証明書とシークレットで新しいクライアントシークレットを選択し、有効期限を指定します。クライアントシークレットが保存されると、Microsoft Teams はキーの値を表示します。この値は一度しか表示されないので、後で使用するために記録しておきます。この値をOAuthClientSecret に使用します。

9. 認証に移動し、アクセストークンオプションを選択します。

10. Select Required Permissions and then click Add. Under Select an API, select the Microsoft Graph and specifically select the following permissions:

    • Group.ReadWrite.All
    • AppCatalog.ReadWrite.All
    • User.Read.All
    • ChannelMessage.Read.All
    • Chat.Read
    • Chat.ReadBasic
    • Chat.ReadWrite
    • Group.Read.All
    • Presence.Read.All

11. 変更を保存します。
12. 管理者の同意が必要なアクセス許可（［アプリケーションの許可］など）を指定した場合は、API のアクセス許可ページで現在のテナントから付与することができます。

管理者の同意の付与

カスタムアプリケーションの中には、Microsoft Entra ID テナント内で操作するために管理者権限が必要なものがあります。 これは特に、サインインしているユーザーなしでアプリケーションを実行できるアプリケーションの許可を使用するアプリケーションに当てはまります。 新しいアプリケーションを作成する際に、「管理者の同意が必要」とマークされた関連するアクセス許可を追加することで、管理者の同意を与えることができます。 管理者の同意は、認証フローでクライアント資格情報を使用する場合にも必要です。

これらのアクセス許可は、管理者によって付与される必要があります。管理者の同意を付与するには：

1. 管理者アカウントでhttps://portal.azure.com にログインします。
2. Microsoft Entra ID ->アプリの登録に移動し、登録済みのアプリケーションを選択します。
3. API のアクセス許可に移動します。
4. アプリケーションの許可にリストされている許可を確認します。ユースケースに必要なAPI スコープが含まれていることを確認してください。
5. 管理者の同意を与えますをクリックして、要求された許可を承認します。

これで、アプリケーションが作成されたテナントにアクセス権限が付与されます。

クライアント資格情報の同意

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

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

1. https://portal.azure.com にログインします。
2. 前述のように、カスタムOAuth アプリケーションを作成します。
3. アプリの登録に移動します。
4. 作成したアプリケーションを探し、API のアクセス許可を開きます。
5. Microsoft Graph アクセス許可を選択します。アクセス許可には2つの異なるアクセス許可セットがあります。委任されたアクセス許可とアプリケーションの許可です。
6. サービスプリンシパルで使用する場合は、アプリケーションの許可を指定します。
7. インテグレーションに必要なアクセス許可を選択します。

SSL 設定のカスタマイズ

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

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

Firewall またはProxy 経由の接続

HTTP プロキシ

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

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

その他のプロキシ

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

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

CData Cloud は、テーブル、ビュー、ストアドプロシージャを使用してMicrosoft Teams オブジェクトを使いやすいSQL データベースとしてモデル化します。これらは、スキーマファイルで定義されます。スキーマファイルは、データの構造と構成を定義する、シンプルで読みやすいテキストファイルです。

Microsoft Teams オブジェクトは、テーブル内の他のオブジェクトとリレーションを持ちます。これらのリレーションは外部キーを使用して表されます。

テーブル

テーブル セクションには標準SQL テーブルの詳細が、ビュー セクションには読み取り専用SQL テーブルの一覧が記載されています。これらには、Microsoft Teams アカウントでのアクセスを想定したサンプルが含まれています。

一般的なテーブルには以下のものが含まれます。

テーブル	説明
Teams	Maintains records of Microsoft Teams instances, including team names, visibility settings, and associated group metadata.
Channels	Tracks Microsoft Teams channel instances, capturing names, privacy settings, types (standard, private), and team associations.
Users	Contains detailed profile, organizational, and directory synchronization information for users in Microsoft Teams, including contact details, licensing, job roles, and Active Directory mappings.
Groups	Holds core metadata about Microsoft 365 Groups, including properties required for provisioning and maintaining Teams.
GroupMembers	Represents the relationship between Microsoft 365 Groups and their members, including user identifiers and membership roles.
GroupOwners	Identifies users assigned as owners of Microsoft 365 Groups that support Teams functionality, enabling management actions.
TeamMembers	Retrieves the list of users who are members of a specific Microsoft Teams team.
ChannelMembers	Retrieves a list of members belonging to a specific Microsoft Teams channel.
Chats	Provides a list of chat threads within Microsoft Teams, including group and one-on-one chats.
ChatMessages	Returns messages sent and received in Microsoft Teams chat threads.
ChannelMessages	Returns messages and replies exchanged within a Microsoft Teams channel.
ChatMembers	Retrieves details of participants in Microsoft Teams chat conversations.
TeamsInstalledApps	Maintains records of Microsoft Teams instances, including team names, visibility settings, and associated group metadata.
Apps	Contains metadata for third-party and internal apps integrated into Microsoft Teams, including installation details, permissions, and usage metrics.
TeamTabs	Documents tabs added to Teams channels, including tab type (Planner, Website, custom app) and configuration data.
Schedules	Defines the overarching containers used in Teams Shifts for organizing shifts, time-off requests, and schedule groups.
Shifts	Captures detailed shift assignments, including assigned user, start and end times, and optional shift notes.
OpenShifts	Stores reusable shift templates created by managers in the Teams Shifts app, used to build individual shift schedules.
TimesOff	Logs time-off entries requested by users through the Microsoft Teams Shifts interface, with reason codes and date ranges.
TimeOffReasons	Contains predefined labels for time-off requests in Teams Shifts, such as vacation, sick leave, or training.

ストアドプロシージャ

ストアドプロシージャ は、標準的なCRUD 操作を超える機能を持つSQL スクリプトです。パラメータを受け取り、関数を実行し、OAuth 認証トークンを管理し、サービスからデータを返すことで、処理の成功または失敗を示します。

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

CData Cloud - Microsoft Teams テーブル

Name	Description
Apps	Contains metadata for third-party and internal apps integrated into Microsoft Teams, including installation details, permissions, and usage metrics.
Channels	Tracks Microsoft Teams channel instances, capturing names, privacy settings, types (standard, private), and team associations.
GroupMembers	Represents the relationship between Microsoft 365 Groups and their members, including user identifiers and membership roles.
GroupOwners	Identifies users assigned as owners of Microsoft 365 Groups that support Teams functionality, enabling management actions.
Groups	Holds core metadata about Microsoft 365 Groups, including properties required for provisioning and maintaining Teams.
OpenShifts	Stores reusable shift templates created by managers in the Teams Shifts app, used to build individual shift schedules.
Schedules	Defines the overarching containers used in Teams Shifts for organizing shifts, time-off requests, and schedule groups.
SchedulingGroups	Segments users into groups within a Teams schedule to streamline shift assignments and reporting.
Shifts	Captures detailed shift assignments, including assigned user, start and end times, and optional shift notes.
Teams	Maintains records of Microsoft Teams instances, including team names, visibility settings, and associated group metadata.
TeamsInstalledApps	Tracks which apps are installed in each Microsoft Team, detailing installation context such as user, group, or channel level.
TeamTabs	Documents tabs added to Teams channels, including tab type (Planner, Website, custom app) and configuration data.
TimeOffReasons	Contains predefined labels for time-off requests in Teams Shifts, such as vacation, sick leave, or training.
TimesOff	Logs time-off entries requested by users through the Microsoft Teams Shifts interface, with reason codes and date ranges.

Contains metadata for third-party and internal apps integrated into Microsoft Teams, including installation details, permissions, and usage metrics.

テーブル固有の情報

Select

この操作は、Microsoft Teams ストアと組織のアプリカタログ（テナントアプリカタログ）のアプリを両方含みます。組織のアプリカタログのみからアプリを取得する場合は、distributionMethod にOrganization を指定してください。 Cloud はMicrosoft Teams API を使って、次のカラムと演算子で作成したWHERE 句の条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• displayName、Id、externalId は、'='、'!='、IN、LIKE、IS、IS NOT 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM Apps WHERE DisplayName = 'MailChimp'

SELECT * FROM Apps WHERE DisplayName IN ('OneNote', 'Teams')

SELECT * FROM Apps WHERE Id LIKE '%-3b58-%'

SELECT * FROM Apps WHERE externalId IN (123, 156)

Delete

アプリは自身の組織のアプリカタログ（テナントアプリカタログ）からのみ削除できます。アプリレコードを削除するには、WHERE 句にId を指定する必要があります。

DELETE FROM Apps WHERE Id = 'ffdb7239-3b58-46ba-b108-7f90a6d8799b'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	A unique identifier automatically assigned to the app when it is added to the Teams app catalog.
displayName	String	False	The human-readable name of the app as defined by the app developer for display in Microsoft Teams.
distributionMethod	String	False	Specifies how the app is made available to users, such as via store listing, side-loading, or organization-wide deployment.
externalId	String	False	The custom identifier defined by the app developer within the Teams app package, used for linking or internal tracking.

Tracks Microsoft Teams channel instances, capturing names, privacy settings, types (standard, private), and team associations.

テーブル固有の情報

Select

すべてのチーム内のすべてのチャネルを取得するかTeamId を指定することで、Channels テーブルをクエリします。 Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。

• TeamId は、'=' およびIN 演算子をサポートします。 他のカラムは、'='、'!='、IN、LIKE、IS、IS NOT 演算子をサポートします。

その他のフィルタはクライアントサイドでCloud 内部で処理されます。 例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM Channels WHERE TeamId IN ('da838338-4e77-4c05-82a6-79d9f0274511', 'da838338-4e77-4c05-82a6-79d9f0274555')

SELECT * FROM Channels WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND Id = '19:[email protected]'

SELECT * FROM Channels WHERE description != 'desc'

Note：テーブルがId カラムでフィルタリングされた場合にのみ、summary カラムに値が入力されます。また、このテーブルのsummary カラムではフィルタリングはできません。

Insert

最低でもTeamId およびDisplayName は、チームに新しいチャネルを追加するために必須です。他のフィールドもすべて指定できます。

INSERT INTO Channels (displayName, description, TeamId) VALUES ('a new channel', 'top tasks channel', 'da838338-4e77-4c05-82a6-79d9f0274511')

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	The unique identifier assigned to the channel by Microsoft Teams.
TeamId	String	False	The identifier of the Team to which this channel belongs, used to associate the channel with its parent Team.
CreatedDateTime	Datetime	False	The date and time when the channel was initially created, in UTC format.
Description	String	False	An optional user-defined description that provides context or purpose for the channel.
DisplayName	String	False	The name of the channel as shown in the Microsoft Teams interface to users.
Email	String	False	The email address assigned to the channel for message forwarding, available in channels with email integration. Read-only.
IsArchived	Bool	False	Indicates whether the channel is currently in a read-only, archived state.
IsFavoriteByDefault	Bool	False	Specifies whether the channel is automatically pinned as a favorite for all team members upon creation. Only configurable via API during team creation.
MembershipType	String	False	Defines the access type of the channel, such as standard, private, or shared. Set at creation time and cannot be changed later.
WebUrl	String	False	The deep link URL to access the channel in Microsoft Teams. This link is generated via the 'Get link to channel' option and should be treated as an opaque identifier.

Represents the relationship between Microsoft 365 Groups and their members, including user identifiers and membership roles.

テーブル固有の情報

Select

チームからすべてを取得するか、GroupId を'=' とIN 演算子で指定することでGroupMembers テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのメンバーのみ返されます。組織の全グループのメンバーを取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• GroupId は、'=' およびIN 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM GroupMembers WHERE GroupId IN ('4729c5e5-f923-4435-8a41-44423d42ea79', 'acabe397-8370-4c31-aeb7-2d7ae6b8cda1')

SELECT * FROM GroupMembers WHERE GroupId = '4729c5e5-f923-4435-8a41-44423d42ea79'

Insert

GroupId およびMemberId フィールドは新しいメンバーをグループに挿入する際には必須です。MemberId はユーザーのId に対応し、Users テーブルをクエリすることでメンバーとして追加したいユーザーのId を取得できます。

INSERT INTO GroupMembers (GroupId, MemberId) VALUES ('acabe397-8370-4c31-aeb7-2d7ae6b8cda1', 'ad9de185-a7af-4ae5-946e-17fc1bf596f0')

Delete

GroupId およびMemberId を指定することでグループメンバーを削除できます。

DELETE FROM GroupMembers WHERE GroupId = 'e557c6d9-3d9a-4658-b51a-4f242c2f8ec8' AND MemberId = 'ba074a2a-69be-45d2-8519-2cc5688bca1e'

Columns

Name	Type	ReadOnly	Description
GroupId [KEY]	String	False	The unique identifier of the Microsoft 365 Group to which the member belongs. Used to link the member to a specific group.
MemberId [KEY]	String	False	The unique identifier of the user who is a member of the specified group. Represents the user's presence in the group membership list.

Identifies users assigned as owners of Microsoft 365 Groups that support Teams functionality, enabling management actions.

テーブル固有の情報

Select

チームからすべてを取得するか、GroupId を'=' とIN 演算子で指定することでGroupOwners テーブルをクエリします。デフォルトでは、自身がメンバーであるグループの所有者のみ返されます。組織の全グループの所有者を取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• GroupId は、'=' およびIN 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM GroupOwners WHERE GroupId IN ('4729c5e5-f923-4435-8a41-44423d42ea79', 'acabe397-8370-4c31-aeb7-2d7ae6b8cda1')

SELECT * FROM GroupOwners WHERE GroupId = '4729c5e5-f923-4435-8a41-44423d42ea79'

Insert

ユーザーをグループの所有者に追加できます。所有者とは、グループオブジェクトを変更できる管理者ではないユーザーのことです。GroupId およびOwnerId フィールドは、新しいメンバーをグループに挿入するために必須です。OwnerId はユーザーのId に対応し、Users テーブルをクエリすることで所有者として追加したいユーザーのId を取得できます。

INSERT INTO GroupOwners (GroupId, OwnerId) VALUES ('acabe397-8370-4c31-aeb7-2d7ae6b8cda1', 'ad9de185-a7af-4ae5-946e-17fc1bf596f0')

Delete

GroupId およびOwnerId を指定することでグループメンバーを削除できます。

DELETE FROM GroupOwners WHERE GroupId = 'e557c6d9-3d9a-4658-b51a-4f242c2f8ec8' AND OwnerId = 'ba074a2a-69be-45d2-8519-2cc5688bca1e'

Columns

Name	Type	ReadOnly	Description
GroupId [KEY]	String	False	The unique identifier of the Microsoft 365 Group for which the user has ownership responsibilities.
OwnerId [KEY]	String	False	The unique identifier of the user who is designated as an owner of the specified group. Owners have elevated permissions such as managing membership and settings.

Holds core metadata about Microsoft 365 Groups, including properties required for provisioning and maintaining Teams.

テーブル固有の情報

Select

デフォルトでは、自身がメンバーであるグループのみ返されます。組織の全グループを取得するには、IncludeAllGroups プロパティをtrue に設定してください。Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• Idは、'=' 演算子をサポート。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM Groups WHERE Id = 'aee54826-eedb-4145-8e6b-4ec1ac4d82c6'

Insert

最低でもDisplayName、MailEnabled、MailNickname、SecurityEnabled が新しいグループを挿入するには必須です。他のフィールドもすべて指定できます。

INSERT INTO Groups (DisplayName, Description, MailEnabled, MailNickname, SecurityEnabled) VALUES ('Test Group', 'Group created from Api', false, 'test123', true)

Update

グループのレコードを更新するには、WHERE 句にId を指定してください。

UPDATE Groups SET Description = 'updated description from api' WHERE Id = 'bc48eaf7-0dc6-45d1-b17a-5b5397466ee1'

Delete

グループのレコードを削除するには、WHERE 句にId を指定してください。

DELETE FROM Groups WHERE Id = 'bc48eaf7-0dc6-45d1-b17a-5b5397466ee1'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	A globally unique identifier for the Microsoft 365 group.
DeletedDateTime	Datetime	False	The date and time when the group was deleted, if applicable.
AllowExternalSenders	Bool	False	Indicates whether users outside the organization are allowed to send emails to the group. Default is false.
AssignedLabels	String	False	A list of sensitivity labels assigned to the group, shown as pairs of label ID and label name.
AssignedLicenses	String	False	The licenses that are currently assigned to the group, used for managing feature availability.
AutoSubscribeNewMembers	Bool	False	Specifies whether newly added members will automatically receive email notifications for group conversations. Settable only via PATCH requests. Default is false.
Classification	String	False	A business impact level label such as low, medium, or high, used to describe the group's sensitivity classification.
CreatedDateTime	Datetime	False	The timestamp representing when the group was originally created.
Description	String	False	A text field to describe the group's purpose or usage within the organization.
DisplayName	String	False	The user-friendly name shown in interfaces like Outlook and Teams for the group.
ExpirationDateTime	Datetime	False	The date and time when the group is scheduled to expire, if expiration policies are applied.
GroupTypes	String	False	Indicates the type of group (such as unified or dynamic) and how its membership is managed.
HideFromAddressLists	Bool	False	If true, hides the group from address books, recipient pickers, and search dialogs in Outlook.
HideFromOutlookClients	Bool	False	If true, hides the group from appearing in Outlook clients like Outlook for Windows and Outlook on the web.
IsSubscribedByMail	Bool	False	Indicates whether the currently signed-in user is subscribed to receive group emails.
LicenseProcessingState_state	String	False	The current state of license processing for group members. Reflects how licensing is being applied.
Mail	String	False	The primary SMTP email address associated with the group's shared mailbox.
MailEnabled	Bool	False	Indicates whether the group supports mail functionality and has an associated mailbox.
MailNickname	String	False	The email alias for the group, unique within the organization's namespace.
MembershipRule	String	False	For dynamic groups, this contains the rule used to determine membership automatically.
MembershipRuleProcessingState	String	False	Shows whether the membership rule engine is actively processing (On) or paused (Paused).
OnPremisesDomainName	String	False	The fully qualified domain name (FQDN) from on-premises directory, if synchronized via Azure AD Connect.
OnPremisesLastSyncDateTime	Datetime	False	The timestamp of the last successful synchronization of the group from on-premises to Azure Active Directory.
OnPremisesNetBiosName	String	False	The NetBIOS name for the group, synchronized from the on-premises directory.
OnPremisesProvisioningErrors	String	False	Describes any synchronization errors that occurred during on-premises provisioning.
OnPremisesSamAccountName	String	False	The SAM account name from on-premises directory. Available only when directory sync is configured.
OnPremisesSecurityIdentifier	String	False	The security identifier (SID) from on-premises directory, used to represent the group in Windows security models.
OnPremisesSyncEnabled	Bool	False	Indicates whether the group is currently being synchronized from on-premises Active Directory. Null means it has never been synced.
PreferredDataLocation	String	False	Specifies the desired Microsoft data center region for storing this group's content.
PreferredLanguage	String	False	The default language preference for the group's communications and user interface.
ProxyAddresses	String	False	A list of proxy email addresses that route messages to the group mailbox.
RenewedDateTime	Datetime	False	The last time the group's expiration policy was renewed, either manually or automatically.
SecurityEnabled	Bool	False	Indicates whether the group functions as a security group for controlling access to resources.
SecurityIdentifier	String	False	The Windows security identifier for the group, used in authorization checks.
Theme	String	False	The color theme assigned to the group in Microsoft 365. Possible values include Teal, Purple, Green, Blue, Pink, Orange, or Red.
UnseenCount	Int	False	The number of group conversations with new posts since the user last viewed the group.
UniqueName	String	False	An alternate, organization-wide unique name used to reference the group.
Visibility	String	False	Defines whether the group is public, private, or hidden, affecting how users can discover and join it.
Members	String	False	A list of unique identifiers representing the users who are members of the group.
Owners	String	False	A list of user IDs representing the individuals who manage the group and have administrative permissions.
UserId	String	False	The unique identifier of a user related to this group record, typically for context-specific queries.

Stores reusable shift templates created by managers in the Teams Shifts app, used to build individual shift schedules.

テーブル固有の情報

Select

チームからすべてを取得するか、GroupId を'=' とIN 演算子で指定することでOpenShifts テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームの空のシフトのみ返されます。組織の全グループのチームの空のシフトアイテムを取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• TeamId は、'=' およびIN 演算子をサポートします。
• Id は、'=' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM OpenShifts WHERE TeamId IN ('da838338-4e77-4c05-82a6-79d9f0274511', 'da834568-4df7-4c05-82a6-79d9f0274515')
SELECT * FROM OpenShifts WHERE Id = 'OPNSHFT_2d49e6dd-d965-4ea2-a399-37f2a082852c' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Insert

チームスケジュールに空のシフトを挿入するにはTeamId と、startDateTime およびendDateTime を含むDraftOpenShift またはSharedOpenShift の情報の、どちらか1つを含む必要があります。

INSERT INTO OpenShifts (TeamId, draftopenshift_openslotcount, draftopenshift_startDateTime, draftopenshift_endDateTime) VALUES ('da838338-4e77-4c05-82a6-79d9f0274511', 4, '2020-09-16T10:00:00.000Z', '2020-09-16T18:00:00.000Z')

Update

空のシフトを更新するには、WHERE 句にレコードId とTeamId が必要です。TeamId、Id、CreatedDateTime 以外のすべてのフィールドを更新できます。

UPDATE OpenShifts SET draftOpenShift_theme = 'blue' WHERE Id = 'OPNSHFT_2d49e6dd-d965-4ea2-a399-37f2a082852c' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Delete

シフトレコードを削除するには、WHERE 句にId とTeamId が必要です。

DELETE FROM OpenShifts WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND Id = 'OPNSHFT_2d49e6dd-d965-4ea2-a399-37f2a082852c'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	The unique identifier for the scheduling group that this open shift is associated with.
CreatedDateTime	Datetime	False	The date and time when the open shift was initially created.
IsStagedForDeletion	Bool	False	Indicates whether the open shift is marked for future deletion but has not yet been removed.
LastModifiedBy_application_displayName	String	False	The name of the application that most recently modified the open shift record.
LastModifiedBy_application_id	String	False	The unique application ID of the system or app that last updated the open shift.
LastModifiedDateTime	Datetime	False	The timestamp of the most recent update to the open shift.
DraftOpenShift_openSlotCount	Int	False	The number of available slots for the draft version of the open shift, which has not yet been shared with the team.
SchedulingGroupId	String	False	The unique identifier for the scheduling group under which this open shift is organized.
SharedOpenShift_openSlotCount	Int	False	The number of available slots in the shared version of the open shift, visible to team members.
TeamId	String	False	The identifier of the Microsoft Team where the open shift is being managed.
DraftOpenShift_displayName	String	False	The label or title assigned to the draft version of the open shift for display purposes.
DraftOpenShift_notes	String	False	Optional notes associated with the draft open shift, such as instructions or shift context.
DraftOpenShift_StartDateTime	Datetime	False	The start time of the draft open shift, before it has been published.
DraftOpenShift_EndDateTime	Datetime	False	The end time of the draft open shift, before it has been published.
SharedOpenShift_displayName	String	False	The label or title assigned to the shared version of the open shift for display to users.
SharedOpenShift_notes	String	False	Optional notes for the shared open shift, visible to team members when selecting shifts.
SharedOpenShift_StartDateTime	Datetime	False	The start time of the shared open shift, which is published and available for team use.
SharedOpenShift_EndDateTime	Datetime	False	The end time of the shared open shift, which is published and available for team use.

Defines the overarching containers used in Teams Shifts for organizing shifts, time-off requests, and schedule groups.

テーブル固有の情報

Select

チームからすべてを取得するか、TeamId を'=' とIN 演算子で指定することでSchedules テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームのスケジュールアイテムのみ返されます。組織の全グループのチームからスケジュールを取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• TeamId は、'=' およびIN 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM Schedules WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Update

スケジュールのレコードを更新するには、WHERE 句にId とTeamId が必要です。

UPDATE Schedules SET timeZone = 'Africa/Casablanca', enabled = true WHERE Id = '4729c5e5-f923-4435-8a41-44423d42ea79' AND TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	A unique identifier representing the schedule instance within Microsoft Teams.
TeamId [KEY]	String	False	The identifier of the Microsoft Team that this schedule is associated with.
Enabled	Bool	False	Specifies whether the schedule is currently active and usable by the associated team.
OfferShiftRequestsEnabled	Bool	False	Indicates whether team members are allowed to offer their scheduled shifts to others.
OpenShiftsEnabled	Bool	False	Indicates whether open shifts are supported, allowing managers to post available shifts for pickup.
ProvisionStatus	String	False	Shows the current state of schedule provisioning. Valid values include notStarted, running, completed, and failed.
ProvisionStatusCode	String	False	Provides additional details explaining why the schedule provisioning could have failed.
SwapShiftsRequestsEnabled	Bool	False	Indicates whether team members are permitted to request a shift swap with another member.
TimeClockEnabled	Bool	False	Specifies whether the time clock feature is enabled, allowing users to clock in and out through Teams.
TimeOffRequestsEnabled	Bool	False	Indicates whether team members are allowed to submit time off requests through the schedule.
TimeZone	String	False	Defines the time zone for the schedule, using IANA tz database format (for example, America/New_York).
WorkforceIntegrationIds	String	False	A comma-separated list of integration identifiers linked to external workforce systems that sync with this schedule.

Segments users into groups within a Teams schedule to streamline shift assignments and reporting.

テーブル固有の情報

Select

チームからすべてを取得するか、TeamId を'=' とIN 演算子で指定することでSchedulingGroups テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームのスケジュールグループのみ返されます。組織の全グループのチームからスケジュールグループを取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• TeamId は、'=' およびIN 演算子をサポートします。
• Id は、'=' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM SchedulingGroups WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND Id = 'TAG_357350ce-2fa2-498d-9967-494296509c32'

Insert

チームにスケジュールグループを挿入するには、TeamId と最低でもDisplayName、IsActive、iconType の内1つのフィールドを指定する必要があります。

INSERT INTO SchedulingGroups (TeamId, DisplayName, IsActive) VALUES ('da838338-4e77-4c05-82a6-79d9f0274511', 'Cashiers', 'true')

Update

スケジュールグループを更新するには、WHERE 句にId とTeamId が必要です。DisplayName およびIsActive フィールドは更新できます。

UPDATE SchedulingGroups SET DisplayName = 'Supervisors' WHERE Id = 'TAG_357350ce-2fa2-498d-9967-494296509c32' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Delete

スケジュールグループを削除するには、WHERE 句にId とTeamId が必要です。

DELETE FROM SchedulingGroups WHERE TeamId = 'acabe397-8370-4c31-aeb7-2d7ae6b8cda1' AND Id = 'TAG_101f11df-e7c0-49f2-8d5c-a9ad085c97aa'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	The unique identifier for the scheduling group within the team.
TeamId	String	False	The identifier of the Microsoft Team to which this scheduling group belongs.
CreatedDateTime	Datetime	False	The date and time when the scheduling group was initially created.
LastModifiedBy_application_displayName	String	False	The display name of the application that most recently modified the scheduling group.
LastModifiedBy_application_id	String	False	The application ID of the app that last updated the scheduling group.
LastModifiedDateTime	Datetime	False	The date and time when the scheduling group was last modified.
DisplayName	String	False	The name displayed for the scheduling group in Microsoft Teams.
IsActive	Bool	False	Indicates whether the scheduling group is currently active and available for use when creating or modifying shifts and schedules.
UserIds	String	False	A comma-separated list of user IDs who are members of this scheduling group. Each ID represents a user assigned to this group.

Captures detailed shift assignments, including assigned user, start and end times, and optional shift notes.

テーブル固有の情報

Select

チームからすべてを取得するか、TeamId を'=' とIN 演算子で指定することでShifts テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームのシフトのみ返されます。組織の全グループのチームのシフトアイテムを取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• TeamId は、'=' およびIN 演算子をサポートします。
• Id は、'=' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM Shifts WHERE TeamId IN ('da838338-4e77-4c05-82a6-79d9f0274511', 'da834568-4df7-4c05-82a6-79d9f0274515')
SELECT * FROM Shifts WHERE Id = 'SHFT_aac21ce9-82b3-4ad1-a841-dadb570c8ebf' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Insert

チームスケジュールにシフトを挿入するには、TeamId とこの休暇が付与される人のUserId に加えて、休暇のstartDateTime およびendDateTime を含むDraftShift またはSharedShift の情報の、どちらか1つを含む必要があります。

INSERT INTO Shifts (TeamId, UserId, draftShift_startDateTime, draftShift_endDateTime) VALUES ('da838338-4e77-4c05-82a6-79d9f0274511', '0409f710-2aa9-4f05-8944-ef382160f1d1', '2019-07-17T07:00:00Z', '2019-07-17T15:00:00Z')
INSERT INTO Shifts (TeamId, UserId, sharedShift_startDateTime, sharedShift_endDateTime) VALUES ('da838338-4e77-4c05-82a6-79d9f0274511', '0409f710-2aa9-4f05-8944-ef382160f1d1', '2019-07-17T07:00:00Z', '2019-07-17T15:00:00Z')

Update

シフトのレコードを更新するには、WHERE 句にId とTeamId が必要です。TeamId、Id、CreatedDateTime 以外のすべてのフィールドを更新できます。

UPDATE Shifts SET draftShift_theme = 'blue', draftShift_displayname = 'somename' WHERE Id = 'SHFT_aac21ce9-82b3-4ad1-a841-dadb570c8ebf' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Delete

シフトのレコードを削除するには、WHERE 句にId とTeamId が必要です。

DELETE FROM Shifts WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND Id = 'SHFT_aac21ce9-82b3-4ad1-a841-dadb570c8ebf'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	A unique identifier for the shift record.
TeamId	String	False	The identifier of the Microsoft Team to which this shift belongs.
UserId	String	False	The unique identifier of the user assigned to this shift.
CreatedDateTime	Datetime	False	The date and time when the shift was first created.
IsStagedForDeletion	Bool	False	Indicates whether the shift is marked for deletion but has not yet been removed.
LastModifiedBy_application_displayName	String	False	The name of the application that most recently modified the shift.
LastModifiedBy_application_id	String	False	The unique application ID of the system or app that last updated the shift.
LastModifiedDateTime	Datetime	False	The date and time of the last update to the shift.
DraftShift_activities	String	False	A list of segments in the draft version of the shift, such as work assignments, breaks, or lunches, specifying what the employee is doing and when.
DraftShift_displayName	String	False	A label assigned to the draft version of the shift for easier identification in the schedule.
DraftShift_notes	String	False	Optional notes added to the draft shift, such as instructions or important reminders.
DraftShift_startDateTime	Datetime	False	The scheduled start time of the draft shift.
DraftShift_endDateTime	Datetime	False	The scheduled end time of the draft shift.
SchedulingGroupId	String	False	The identifier of the scheduling group to which this shift is assigned.
SharedShift_activities	String	False	A list of activities in the published (shared) version of the shift, such as assignments, breaks, or other scheduled duties.
SharedShift_displayName	String	False	A label assigned to the shared version of the shift for users to see on the calendar.
SharedShift_notes	String	False	Optional notes attached to the shared version of the shift for team member reference.
SharedShift_startDateTime	Datetime	False	The published start time of the shift that is visible to the user.
SharedShift_endDateTime	Datetime	False	The published end time of the shift that is visible to the user.

Maintains records of Microsoft Teams instances, including team names, visibility settings, and associated group metadata.

テーブル固有の情報

Select

チームからすべてを取得するか、GroupId を'=' とIN 演算子で指定することでTeams テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームのみ返されます。組織の全グループのチームを取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• GroupId は、'=' およびIN 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM Teams WHERE GroupId IN ('4729c5e5-f923-4435-8a41-44423d42ea79', 'acabe397-8370-4c31-aeb7-2d7ae6b8cda1')

SELECT * FROM Teams WHERE GroupId = '4729c5e5-f923-4435-8a41-44423d42ea79'

Insert

最低でもGroupId およびDisplayName は、グループに新しいチームを追加するために必須です。他のフィールドもすべて指定できます。

INSERT INTO Teams (DisplayName, GroupId, funSettings_allowGiphy) VALUES ('Cool team', 'acabe397-8370-4c31-aeb7-2d7ae6b8cda1', false)

Update

チームのレコードを更新するには、WHERE 句にId を指定してください。アーカイブされていないチームのみ更新できます。

UPDATE Teams SET DisplayName = 'My Team', funSettings_allowGiphy = false, funSettings_allowGiphy = true, funSettings_allowStickersAndMemes = true, funSettings_allowCustomMemes = false, guestSettings_allowCreateUpdateChannels = true, guestSettings_allowDeleteChannels = false, memberSettings_allowCreateUpdateChannels = false, memberSettings_allowDeleteChannels = true, Description = 'some desc' WHERE Id = '4729c5e5-f923-4435-8a41-44423d42ea79'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	The unique identifier for the Microsoft Team.
GroupId	String	False	The unique identifier for the Microsoft 365 Group backing the Team.
DisplayName	String	False	The user-friendly name of the Team as shown in Microsoft Teams.
Description	String	False	An optional description providing context or purpose for the Team.
Classification	String	False	An optional label that describes the data or business sensitivity level of the Team, based on predefined classifications in the organization's directory.
CreatedDateTime	Datetime	False	The date and time when the Team was created.
FunSettings_allowCustomMemes	Bool	False	Indicates whether users are allowed to upload and use custom memes in the Team chat.
FunSettings_allowGiphy	Bool	False	Indicates whether users are allowed to search and share Giphy images within the Team.
FunSettings_allowStickersAndMemes	Bool	False	Indicates whether users can use pre-built stickers and memes in the Team.
FunSettings_giphyContentRating	String	False	Specifies the Giphy content rating for the Team. Acceptable values include moderate and strict.
GuestSettings_allowCreateUpdateChannels	Bool	False	Indicates whether guest users are allowed to create and update channels within the Team.
GuestSettings_allowDeleteChannels	Bool	False	Indicates whether guest users are allowed to delete channels within the Team.
InternalId	String	False	A system-level internal identifier used for auditing and integrations such as Office 365 Management Activity API.
IsArchived	Bool	False	Indicates whether the Team is archived, meaning it is in read-only mode and no changes can be made.
MemberSettings_allowAddRemoveApps	Bool	False	If true, Team members are allowed to install or remove apps within the Team.
MemberSettings_allowCreatePrivateChannels	Bool	False	If true, Team members can create and manage private channels.
MemberSettings_allowCreateUpdateChannels	Bool	False	If true, Team members are permitted to create new channels or update existing ones.
MemberSettings_allowCreateUpdateRemoveConnectors	Bool	False	If true, Team members can configure connectors, including creating, updating, or removing them.
MemberSettings_allowCreateUpdateRemoveTabs	Bool	False	If true, Team members can add, update, or remove tabs in Team channels.
MemberSettings_allowDeleteChannels	Bool	False	If true, Team members have permission to delete channels.
MessagingSettings_allowChannelMentions	Bool	False	If true, allows users to use @channel mentions to notify all members of a channel.
MessagingSettings_allowOwnerDeleteMessages	Bool	False	If true, allows Team owners to delete any message posted in the Team.
MessagingSettings_allowTeamMentions	Bool	False	If true, allows users to use @team mentions to notify all members of the Team.
MessagingSettings_allowUserDeleteMessages	Bool	False	If true, allows users to delete their own messages.
MessagingSettings_allowUserEditMessages	Bool	False	If true, allows users to edit their own messages after sending.
Specialization	String	False	Indicates whether the Team is configured for a special use case (such as education or healthcare), which affects available features.
Visibility	String	False	Specifies whether the Team is public or private. Public teams can be discovered and joined by anyone in the organization.
WebUrl	String	False	A deep link to open the Team directly in the Microsoft Teams client. This link should not be parsed or altered.
summary_guestsCount	Integer	True	The number of guest users who are part of the Team.
summary_membersCount	Integer	True	The number of members in the Team, excluding guests and owners.
summary_ownersCount	Integer	True	The number of users who have owner-level permissions in the Team.

Tracks which apps are installed in each Microsoft Team, detailing installation context such as user, group, or channel level.

Columns

Name	Type	ReadOnly	Description
TeamId	String	False	The unique identifier of the Microsoft Team where the app is installed.
TeamsAppId	String	False	The identifier of the Teams app instance installed in the Team.
TeamsAppDefinitionDescription	String	False	A detailed description of the app as defined in the app's manifest or Teams App Catalog.
TeamsAppDefinitionDisplayName	String	False	The name of the Teams app as shown to users in the Microsoft Teams client.
TeamsAppDefinitionLastModifiedDateTime	Datetime	False	The timestamp indicating when the app definition was last updated in the Teams App Catalog.
TeamsAppDefinitionPublishingState	String	False	The current publishing state of the app definition, such as submitted, published, or rejected.
TeamsAppDefinitionShortDescription	String	False	A brief summary of the app's functionality or purpose, taken from the app manifest.
TeamsAppDefinitionVersion	String	False	The version number of the app definition currently installed in the Team.

Documents tabs added to Teams channels, including tab type (Planner, Website, custom app) and configuration data.

テーブル固有の情報

Select

TeamTabs テーブルをクエリするには、特定のチームに属する特定のチャネルのタブを取得するために、TeamId およびChannelId フィルタを指定する必要があります。 Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• TeamId およびChannelId は、'=' およびIN 演算子をサポートします。 他のカラムは、'='、'!='、IN、LIKE、IS、IS NOT 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM TeamTabs WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND ChannelId = '19:[email protected]'
SELECT * FROM TeamTabs WHERE TeamId = '12d95e4d-f90f-434c-b280-dd7f8b8615e5' AND ChannelId IN (SELECT Id FROM Channels WHERE TeamId = '12d95e4d-f90f-434c-b280-dd7f8b8615e5') AND Id LIKE '%-ade1-400a-a82b-e7a435199b7a'
SELECT * FROM TeamTabs WHERE TeamId = '12d95e4d-f90f-434c-b280-dd7f8b8615e5' AND ChannelId IN (SELECT Id FROM Channels WHERE TeamId = '12d95e4d-f90f-434c-b280-dd7f8b8615e5') AND configuration_entityId IS NOT NULL

Insert

最低でもTeamId、ChannelId、およびAppId は、チームに新しいタブを追加するために必須です。他のフィールドもすべて指定できます。

INSERT INTO TeamTabs (TeamId, ChannelId, DisplayName, AppID) VALUES ('4729c5e5-f923-4435-8a41-44423d42ea79', '19:[email protected]', 'new tab for test', '0d820ecd-def2-4297-adad-78056cde7c78')

Update

タブのレコードを更新するには、WHERE 句にId、ChannelId、TeamId を指定してください。

UPDATE TeamTabs SET DisplayName = 'updatetabname' WHERE Id = 'c41cbfe0-7713-44d6-96dd-b692569f1766' AND ChannelId = '19:[email protected]' AND TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79'

Delete

タブのレコードを削除するには、WHERE 句にId、ChannelId、TeamId を指定してください。

DELETE FROM TeamTabs WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND ChannelId = '19:[email protected]' AND Id = '16ba49df-d7e1-4dc7-b6c3-ea721d327d38'

Columns

Name	Type	ReadOnly	Description
id [KEY]	String	False	A unique identifier for the specific tab instance within a channel.
AppId	String	False	The identifier of the app associated with the tab.
ChannelId	String	False	The identifier of the channel where the tab is located.
Configuration_contentUrl	String	False	The URL used by Teams to render the tab content inside the Teams client. This is required for the tab to function.
Configuration_entityId	String	False	A custom identifier for the entity represented by the tab, used by the app to load specific data or context.
Configuration_removeUrl	String	False	The callback URL invoked by the Teams client when a tab is removed. Used for cleanup or telemetry.
Configuration_websiteUrl	String	False	A publicly accessible URL used to view the tab's contents outside of Microsoft Teams.
DisplayName	String	False	The display name of the tab, shown in the channel tab navigation.
WebUrl	String	False	A deep link URL that opens the tab instance directly in the Teams client.
TeamsApp_id	String	True	The unique identifier for the Teams app definition used by the tab.
TeamId	String	False	The identifier of the Team that contains the tab and its associated channel.

Contains predefined labels for time-off requests in Teams Shifts, such as vacation, sick leave, or training.

テーブル固有の情報

Select

チームからすべてを取得するか、TeamId を指定することでTimeOffReasons テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームの休暇理由のみ返されます。組織の全グループのチームから休暇理由を取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• TeamId は、'=' およびIN 演算子をサポートします。
• Id は、'=' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM TimeOffReasons WHERE TeamId IN ('da838338-4e77-4c05-82a6-79d9f0274511', 'da834568-4df7-4c05-82a6-79d9f0274515')
SELECT * FROM TimeOffReasons WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND Id = 'SHFT_0aee55c3-2bac-4ede-9792-26838fc8bb01'

Insert

チームに休暇理由を挿入するには、TeamId と最低でもDisplayName、IsActive、iconType の内1つのフィールドを指定する必要があります。

INSERT INTO TimeOffReasons (TeamId, DisplayName, IsActive) VALUES ('acabe397-8370-4c31-aeb7-2d7ae6b8cda1', 'a new reason', 'true')

Delete

休暇理由のレコードを削除するには、WHERE 句にId とTeamId が必要です。

DELETE FROM TimeOffReasons WHERE Id = 'SHFT_dd50b99a-e2d8-44ad-a445-53ad58bfc37b' AND TeamId = 'acabe397-8370-4c31-aeb7-2d7ae6b8cda1'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	The unique identifier for the time off reason entry.
TeamId	String	False	The identifier of the Microsoft Team that this time off reason is associated with.
CreatedDateTime	Datetime	False	The date and time when the time off reason was initially created.
LastModifiedBy_application_displayName	String	False	The name of the application that most recently modified this time off reason.
LastModifiedBy_application_id	String	False	The application ID of the service or app that last updated this time off reason.
LastModifiedDateTime	Datetime	False	The timestamp of the most recent update to the time off reason entry.
DisplayName	String	False	The display name for the time off reason, such as Vacation, Sick Leave, or Jury Duty. Required field.
IconType	String	False	The icon representing the time off reason. Supported values: none, car, calendar, running, plane, firstAid, doctor, notWorking, clock, juryDuty, globe, cup, phone, weather, umbrella, piggyBank, dog, cake, trafficCone, pin, sunny.
IsActive	Bool	False	Indicates whether this time off reason is currently active and available for use in new or updated time off requests.

Logs time-off entries requested by users through the Microsoft Teams Shifts interface, with reason codes and date ranges.

テーブル固有の情報

Select

チームからすべてを取得するか、TeamId を指定することでTimesOff テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームの休暇のみ返されます。組織の全グループのチームから休暇を取得するには、IncludeAllGroups プロパティをtrue に設定してください。 Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• TeamId は、IN および'=' 演算子をサポートします。
• Id は、'=' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM TimesOff WHERE TeamId IN ('da838338-4e77-4c05-82a6-79d9f0274511', 'da834568-4df7-4c05-82a6-79d9f0274515')
SELECT * FROM TimesOff WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Insert

チームスケジュールに休暇を挿入するには、TeamId とこの休暇が付与される人のUserId に加えて、休暇のstartDateTime、endDateTime およびtimeOff_ReasonId を含むDraftTimeOff またはSharedTimeOff の情報の、どちらかを含む必要があります。

INSERT INTO TimesOff (TeamId, UserId, sharedTimeOff_startDateTime, sharedTimeOff_endDateTime, SharedTimeOff_TimeOffReasonId) VALUES ('da838338-4e77-4c05-82a6-79d9f0274511', '0409f710-2aa9-4f05-8944-ef382160f1d1', '2019-03-11T07:00:00Z', '2019-03-12T07:00:00Z', 'TOR_97de5f58-462b-4bde-8a95-038b4073bffb')

Update

休暇のレコードを更新するには、WHERE 句にId とTeamId が必要です。TeamId、Id、CreatedDateTime 以外のすべてのフィールドを更新できます。

UPDATE Timesoff SET draftTimeOff_timeOffReasonId = 'TOR_97de5f58-462b-4bde-8a95-038b4073bffb' WHERE Id = 'SHFT_dd50b99a-e2d8-44ad-a445-53ad58bfc37b' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Delete

休暇のレコードを削除するには、WHERE 句にId とTeamId が必要です。

DELETE FROM TimesOff WHERE Id = 'SHFT_dd50b99a-e2d8-44ad-a445-53ad58bfc37b' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	False	A unique identifier for the time off entry.
UserId	String	False	The unique identifier of the user who submitted or was assigned this time off request.
TeamId	String	False	The identifier of the Microsoft Team associated with the time off request.
CreatedDateTime	Datetime	False	The date and time when the time off request was first created.
IsStagedForDeletion	Bool	False	Indicates whether the time off entry is marked for deletion but has not yet been removed.
LastModifiedBy_application_displayName	String	False	The name of the application that most recently modified the time off entry.
LastModifiedBy_application_id	String	False	The unique application ID of the system or service that last modified the entry.
LastModifiedDateTime	Datetime	False	The date and time when the time off entry was last updated.
DraftTimeOff_timeOffReasonId	String	False	The identifier for the reason associated with the draft version of the time off request.
SharedTimeOff_timeOffReasonId	String	False	The identifier for the reason associated with the shared (published) version of the time off request.
DraftTimeOff_StartDateTime	Datetime	False	The scheduled start date and time for the draft version of the time off.
DraftTimeOff_EndDateTime	Datetime	False	The scheduled end date and time for the draft version of the time off.
SharedTimeOff_StartDateTime	Datetime	False	The scheduled start date and time for the published version of the time off.
SharedTimeOfft_EndDateTime	Datetime	False	The scheduled end date and time for the published version of the time off.

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

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

CData Cloud - Microsoft Teams ビュー

Name	Description
CallRecordParticipants	Details of call sessions on MS Teams.
CallRecords	Provides an overview of call activity in Microsoft Teams, including metadata such as call duration and type.
CallRecordSessions	Lists sessions within Microsoft Teams calls, with details on session start and end times.
CallRecordSessionSegments	Breaks down call sessions in Microsoft Teams into smaller segments for granular tracking of media streams.
ChannelMembers	Retrieves a list of members belonging to a specific Microsoft Teams channel.
ChannelMessages	Returns messages and replies exchanged within a Microsoft Teams channel.
ChatMembers	Retrieves details of participants in Microsoft Teams chat conversations.
ChatMessageAttachments	Get Chat Message Attachments.
ChatMessageMentions	Get Chat Message Mentions.
ChatMessages	Returns messages sent and received in Microsoft Teams chat threads.
Chats	Provides a list of chat threads within Microsoft Teams, including group and one-on-one chats.
DirectRoutingCalls	Displays direct routing call records in Microsoft Teams for telephony integration analysis.
PstnCalls	Displays Public Switched Telephone Network (PSTN) call records in Microsoft Teams.
TeamMembers	Retrieves the list of users who are members of a specific Microsoft Teams team.
UserPresence	Stores real-time presence information for Microsoft Teams users.
Users	Contains detailed profile, organizational, and directory synchronization information for users in Microsoft Teams, including contact details, licensing, job roles, and Active Directory mappings.

Details of call sessions on MS Teams.

Table Specific Information

Select

Query the CallRecordParticipants table to get details of PeerToPeer and Group Call session information on Teams. The CallRecordsId should be acquired by following instructions in Get callRecord. Custom App and Client Credentials should be used. See Entra ID（Azure AD）アプリケーションの作成

• CallRecordParticipants supports '=' operator.

The following is an example query:

SELECT * FROM CallRecordParticipants WHERE CallRecordsId = 'b6ee7caa-f730-451f-b6bd-24592a3429a7'

Columns

Name	Type	Description
Id [KEY]	String	Call record Id
CallRecordsId	String	Call record Id. Mandatory internal column to be used in WHERE clause
displayName	String
userId	String
tenantId	String
userPrincipalName	String

Provides an overview of call activity in Microsoft Teams, including metadata such as call duration and type.

テーブル固有の情報

Select

CallRecord テーブルをクエリして、Teams のピアツーピアおよびグループ通話セッションセグメントの詳細を取得します。 CallRecordsId は、callRecord の取得の説明に従って取得してください。 カスタムアプリおよびクライアントクレデンシャルを使用する必要があります。Entra ID（Azure AD）アプリケーションの作成 を参照してください。

• CallRecordsId は、'=' 演算子をサポートします。

次にクエリの例を示します。

SELECT * FROM CallRecords WHERE CallRecordsId = 'b6ee7caa-f730-451f-b6bd-24592a3429a7'

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the call record in Microsoft Teams.
EndDateTime	Datetime	Timestamp indicating when the call ended.
JoinWebUrl	String	Web URL that participants used to join the meeting.
LastModifiedDateTime	Datetime	Timestamp of the most recent modification to this call record.
Modalities	String	Communication modes used during the call, which can include audio, video, videoBasedScreenSharing, data, and screenSharing.
StartDateTime	Datetime	Timestamp indicating when the call or meeting started.
Type	String	Specifies whether the call was peerToPeer or groupCall.
Version	Long	Version number of the call record for internal tracking.
organizer_v2_id	String	Unique identifier for the meeting organizer in Microsoft Teams.
organizer_v2_displayName	String	Full display name of the user who organized the meeting.
organizer_v2_userId	String	User ID of the meeting organizer within Microsoft Teams.
organizer_v2_tenantId	String	Tenant ID associated with the meeting organizer's Microsoft 365 account.
organizer_v2_userPrincipalName	String	User Principal Name (UPN) of the meeting organizer.
CallRecordsId	String	Mandatory internal column representing the call record ID, used in WHERE clauses to filter records.

Lists sessions within Microsoft Teams calls, with details on session start and end times.

テーブル固有の情報

Select

CallRecordSessions テーブルをクエリして、Teams のピアツーピアおよびグループ通話セッションセグメントの情報を取得します。 CallRecordsId は、callRecord の取得の説明に従って取得してください。 カスタムアプリおよびクライアントクレデンシャルを使用する必要があります。Entra ID（Azure AD）アプリケーションの作成 を参照してください。

• CallRecordSessions は、'=' 演算子をサポートします。

次にクエリの例を示します。

SELECT * FROM CallRecordSessions WHERE CallRecordsId = 'b6ee7caa-f730-451f-b6bd-24592a3429a7'

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the call record session in Microsoft Teams.
Callee_UserAgent_ApplicationVersion	String	Version of the application used by the callee's user agent during the session.
Callee_UserAgent_HeaderValue	String	Header value from the callee's user agent during the session.
Caller_UserAgent_ApplicationVersion	String	Version of the application used by the caller's user agent during the session.
Caller_UserAgent_HeaderValue	String	Header value from the caller's user agent during the session.
EndDateTime	Datetime	Timestamp indicating when the call session ended.
FailureInfo_Reason	String	Reason for the call session failure, if applicable.
FailureInfo_Stage	String	Stage at which the call session failure occurred, if applicable.
Modalities	String	Communication modes used in the session, which can include audio, video, videoBasedScreenSharing, data, and screenSharing.
StartDateTime	Datetime	Timestamp indicating when the call session started.
CallRecordsId	String	Mandatory internal column representing the call record ID, used in WHERE clauses to filter records.

Breaks down call sessions in Microsoft Teams into smaller segments for granular tracking of media streams.

テーブル固有の情報

Select

CallRecordSessionSegments テーブルをクエリして、Teams のピアツーピアおよびグループ通話セッションセグメントの詳細を取得します。 CallRecordsId は、callRecord の取得の説明に従って取得してください。 カスタムアプリおよびクライアントクレデンシャルを使用する必要があります。Entra ID（Azure AD）アプリケーションの作成 を参照してください。

• CallRecordSessionSegments は、'=' 演算子をサポートします。

次にクエリの例を示します。

SELECT * FROM CallRecordSessionSegments WHERE CallRecordsId = 'b6ee7caa-f730-451f-b6bd-24592a3429a7'

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the call record session segment in Microsoft Teams.
Callee_UserAgent_ApplicationVersion	String	Version of the application used by the callee's user agent during this session segment.
Callee_UserAgent_HeaderValue	String	Header value from the callee's user agent during this session segment.
Caller_UserAgent_ApplicationVersion	String	Version of the application used by the caller's user agent during this session segment.
Caller_UserAgent_HeaderValue	String	Header value from the caller's user agent during this session segment.
EndDateTime	Datetime	Timestamp indicating when the session segment ended.
FailureInfo_Reason	String	Reason for failure during the session segment, if applicable.
FailureInfo_Stage	String	Stage of the call session where the failure occurred, if applicable.
Media	String	Details about media streams used during the session segment, such as audio or video.
StartDateTime	Datetime	Timestamp indicating when the session segment started.
CallRecordsId	String	Mandatory internal column representing the call record ID, used in WHERE clauses to filter records.

Retrieves a list of members belonging to a specific Microsoft Teams channel.

Table Specific Information

SELECT

The Cloud uses the Microsoft Teams API to process WHERE clause conditions built with the following columns and operators:

• ChannelId supports the '=' operator.
• TeamId supports the '=,IN' operators.

Note: ChannelId and TeamId must be included in the WHERE clause to retrieve any data from the ChannelMembers view. These filters are required by the API and are evaluated server-side.

The rest of the filter is executed client-side within the Cloud.

For example, the following queries are processed server-side:

SELECT * FROM ChannelMembers WHERE ChannelId = '19:[email protected]' AND TeamId = 'f7985bee-7fb4-404d-a954-5ba68ae7c8db'

SELECT * FROM ChannelMembers WHERE ChannelId = '19:[email protected]' AND TeamId IN ('f7985bee-7fb4-404d-a954-5ba68ae7c8db', 'da838338-4e77-4c05-82a6-79d9f0274511')

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the channel member in Microsoft Teams.
TeamId	String	Identifier of the team to which the channel belongs.
DisplayName	String	Full display name of the channel member.
email	String	Email address of the channel member.
Roles	String	Roles assigned to the channel member, such as owner or member.
TenantId	String	Identifier of the Microsoft 365 tenant associated with the member.
UserId	String	Unique user identifier for the channel member.
StartDateTime	Datetime	Timestamp indicating when the membership history for the channel started.
ChannelId	String	Identifier of the Microsoft Teams channel where the member is assigned.

Returns messages and replies exchanged within a Microsoft Teams channel.

Table Specific Information

Select

The Cloud uses the Microsoft Teams API to process WHERE clause conditions built with the columns and operator shown below. The rest of the filter is executed client-side within the Cloud.

• TeamId supports '=' operator.
• ChannelId supports '=' operator.
• Id supports '=' operator.
• ReplyToId supports '=' operator.

Note: ChannelId and TeamId are required columns to get results from this view, and must both be specified in the WHERE clause. The data cannot be retrieved by the Cloud using ChannelId alone.

Example Queries

The Cloud executes this by fetching ChannelID and TeamId from Microsoft Teams API:

SELECT * FROM ChannelMessages

This query uses the TeamID from Microsoft Teams API to obtain the ChannelID:

SELECT * FROM ChannelMessages WHERE TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79'

SELECT * FROM ChannelMessages WHERE TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79' AND ChannelId = '19:[email protected]'

SELECT * FROM ChannelMessages WHERE TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79' AND ChannelId = '19:[email protected]' AND Id='1688061957561'

To get all the replies in a message:

SELECT * FROM ChannelMessages WHERE TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79' AND ChannelId = '19:[email protected]' AND ReplyToId='1688061957561'

SELECT * FROM ChannelMessages WHERE TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79' AND ChannelId = '19:[email protected]' AND Id='1688061957562' AND ReplyToId='1688061957561'

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the channel message in Microsoft Teams.
BodyContent	String	Plaintext or rich text content of the message body.
BodyContentType	String	Specifies the format of the message body content, such as text or HTML.
ChannelId	String	Identifier of the Microsoft Teams channel where the message was posted.
TeamId	String	Identifier of the team associated with the channel.
Mentions	String	List of entities mentioned in the message. Supported entities include user, bot, team, and channel.
Reactions	String	List of reactions applied to the channel message, such as like or heart.
Attachments	String	References to objects attached to the message, such as files, tabs, or meetings.
Importance	String	Priority level of the message, such as normal, high, or urgent.
CreatedDateTime	Datetime	Timestamp indicating when the message was created.
LastEditedDateTime	Datetime	Timestamp indicating when the message was last edited.
LastModifiedDateTime	Datetime	Timestamp indicating when the message was last updated.
DeletedDateTime	Datetime	Timestamp indicating when the message was deleted, or null if it has not been deleted.
MessageType	String	Type of message, such as standard or system notification.
ChatId	String	Identifier of the chat thread when the message is part of a threaded conversation.
Etag	String	Version identifier for the message used for concurrency control.
FromUserDisplayName	String	Display name of the user who sent the message.
FromUserId	String	Unique identifier of the user who sent the message.
FromUserUserIdentityType	String	Specifies the identity type of the user who sent the message.
FromApplication	String	Name of the application that sent the message, if applicable.
FromDevice	String	Name of the device used to send the message, if available.
Locale	String	Locale setting of the message as defined by the client application, typically en-us.
PolicyViolation	String	Details about any policy violations associated with the message.
ReplyToId	String	Identifier of the parent message when the current message is part of a reply thread.
Subject	String	Subject line of the message in plaintext, if provided.
Summary	String	Summary text of the message for use in notifications, previews, or fallback views. Applies only to channel messages.
WebUrl	String	Direct link to view the message in Microsoft Teams.
EventDetail	String	Details about the event associated with the message, if applicable.

Retrieves details of participants in Microsoft Teams chat conversations.

Table Specific Information

SELECT

The Cloud use the Microsoft Teams API to process WHERE clause conditions built with the following columns and operators:

• UserId supports the '=' operator.
• ChatId supports the '=,IN' operators.

Note: UserId and ChatId must be included in the WHERE clause to retrieve any data from the ChatMembers view. These filters are required by the API and are evaluated server-side.

The rest of the filter is executed client-side within the Cloud.

For example, the following queries are processed server-side:

SELECT * FROM ChatMembers WHERE UserId = 'e4ea490e-b30c-4b1e-92b0-337117920315' AND ChatId = '19:92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe_90a27c51-5c74-453b-944a-134ba86da790@unq.gbl.spaces'

SELECT * FROM ChatMembers WHERE UserId = 'e4ea490e-b30c-4b1e-92b0-337117920315' AND ChatId IN ('19:92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe_90a27c51-5c74-453b-944a-134ba86da790@unq.gbl.spaces', '19:92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe_b62067c0-8314-42f8-9d02-d1c2051dfcdc@unq.gbl.spaces')

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the chat member in Microsoft Teams.
ChatId	String	Identifier of the chat to which the member belongs.
DisplayName	String	Full display name of the chat member.
email	String	Email address of the chat member.
Roles	String	Roles assigned to the chat member, such as owner or participant.
TenantId	String	Identifier of the Microsoft 365 tenant associated with the chat member.
UserId	String	Unique user identifier for the chat member.
StartDateTime	Datetime	Timestamp indicating when the membership history for the chat started.

Get Chat Message Attachments.

Table Specific Information

Select

The Cloud uses the Microsoft Teams API to process WHERE clause conditions built with the following column and operator:

• ChatId supports '=' operator.

The rest of the filter is executed client side within the Cloud.

The following is an example query:

SELECT * FROM ChatMessageAttachments WHERE ChatId = '19:92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe_e4ea490e-b30c-4b1e-92b0-337117920315@unq.gbl.spaces'

Columns

Name	Type	Description
Id	String	The Chat Messages Id.
ChatId	String	The Chat Id.
Attachments_Id	String	The Id of the attachment.
Content	String	The Content of the attachment.
ContentType	String	The ContentType of the attachment.
ContentUrl	String	The ContentUrl of the attachment.
Name	String	The Name of the attachment.
TeamsAppId	String	The TeamsAppId of the attachment.
ThumbnailUrl	String	The ThumbnailUrl of the attachment.

Get Chat Message Mentions.

Table Specific Information

Select

The Cloud uses the Microsoft Teams API to process WHERE clause conditions built with the following column and operator:

• ChatId supports '=' operator.

The rest of the filter is executed client side within the Cloud.

The following is an example query:

SELECT * FROM ChatMessageMentions WHERE ChatId = '19:92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe_e4ea490e-b30c-4b1e-92b0-337117920315@unq.gbl.spaces'

Columns

Name	Type	Description
Id	String	The Chat Messages Id.
ChatId	String	The Chat Id.
Mentions_Id	Int	The Id of the mention.
MentionText	String	The MentionText of the mention.
User_Id	String	The User_Id of the mention.
User_DisplayName	String	The User_DisplayName of the mention.
User_TenantId	String	The User_TenantId of the mention.
Application_Id	String	The Application_Id of the mention.
Application_DisplayName	String	The Application_DisplayName of the mention.
Application_TenantId	String	The Application_TenantId of the mention.
Device_Id	String	The Device_Id of the mention.
Device_DisplayName	String	The Device_DisplayName of the mention.
Device_TenantId	String	The Device_TenantId of the mention.
Conversation_Id	String	The Conversation_Id of the mention.
Conversation_DisplayName	String	The Conversation_DisplayName of the mention.
Conversation_ConversationIdentityType	String	The Conversation_ConversationIdentityType of the mention.

Returns messages sent and received in Microsoft Teams chat threads.

Table Specific Information

Select

The Cloud uses the Microsoft Teams API to process WHERE clause conditions built with the following column and operator:

• ChatId supports '=' operator.

The rest of the filter is executed client side within the Cloud.

The following is an example query:

SELECT * FROM ChatMessages WHERE ChatId = '19:92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe_e4ea490e-b30c-4b1e-92b0-337117920315@unq.gbl.spaces'

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the chat message in Microsoft Teams.
ChatId	String	Identifier of the chat thread containing the message.
BodyContent	String	Plaintext or rich text content of the chat message body.
BodyContentType	String	Specifies the format of the message body content, such as text or HTML.
MessageType	String	Type of chat message, such as standard or system notification.
CreatedDateTime	Datetime	Timestamp indicating when the chat message was created.
LastEditedDateTime	Datetime	Timestamp indicating when the chat message was last edited.
LastModifiedDateTime	Datetime	Timestamp indicating when the chat message was last updated.
DeletedDateTime	Datetime	Timestamp indicating when the chat message was deleted, or null if it has not been deleted.
Reactions	String	List of reactions applied to the chat message, such as like or heart.
Mentions	String	List of entities mentioned in the chat message. Supported entities include user, bot, team, and channel.
Attachments	String	References to objects attached to the message, such as files, tabs, or meetings.
Importance	String	Priority level of the chat message, such as normal, high, or urgent.
FromUserDisplayName	String	Display name of the user who sent the message.
FromUserId	String	Unique identifier of the user who sent the message.
FromUserIdentityType	String	Specifies the identity type of the user who sent the message.
ChannelIdentity	String	Identifier of the Microsoft Teams channel associated with the message, if applicable.
Locale	String	Locale setting of the message as defined by the client application, typically en-us.
ReplyToId	String	Identifier of the parent chat message if this message is part of a reply thread.
Subject	String	Subject line of the chat message, in plaintext.
Summary	String	Summary text of the chat message for use in notifications, previews, or fallback views. Applies only to channel chat messages.
PolicyViolation	String	Details about any policy violations associated with the chat message.
Etag	String	Version identifier for the chat message used for concurrency control.
FromApplication	String	Name of the application that sent the message, if applicable.
FromDevice	String	Name of the device used to send the message, if available.
WebUrl	String	Direct link to view the message in Microsoft Teams.
EventDetail	String	Details about the event associated with the chat message, if applicable.

Provides a list of chat threads within Microsoft Teams, including group and one-on-one chats.

Table Specific Information

Select

The Cloud use the Microsoft Teams API to process WHERE clause conditions built with the following column and operator:

• Id supports '=' operator.

The rest of the filter is executed client side within the Cloud.

The following is an example query:

SELECT * FROM Chats WHERE Id = '19:32caef50-395c-425a-a994-e3fa4569b23b_92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe@unq.gbl.spaces'

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the chat in Microsoft Teams.
ChatType	String	Specifies the type of chat, such as one-on-one, group, or meeting chat.
UserId	String	Identifier of the user associated with the chat.
CreatedDateTime	Datetime	Timestamp indicating when the chat was created.
LastUpdatedDateTime	Datetime	Timestamp indicating when the chat was last updated.
Topic	String	Subject or topic of the chat, if specified.
IsHiddenForAllMembers	Bool	Indicates whether the chat is hidden for all members.

Displays direct routing call records in Microsoft Teams for telephony integration analysis.

テーブル固有の情報

Select

カスタムアプリおよびクライアントクレデンシャルを使用する必要があります。Entra ID（Azure AD）アプリケーションの作成 を参照してください。 Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• FromDate は、'=' 演算子をサポートします。
• ToDate は、'=' 演算子をサポートします。

次にクエリの例を示します。

SELECT * FROM DirectRoutingCalls WHERE FromDate = '2021-01-01'

SELECT * FROM DirectRoutingCalls WHERE FromDate = '2021-01-01' AND ToDate = '2021-02-09'

Note：FromDate とToDate は必須パラメータであり、指定されていない場合はデフォルトの日付を日付範囲90日で使用します。

Columns

Name	Type	Description
Id	String	Unique identifier for the direct routing call in Microsoft Teams.
CorrelationId	String	Correlation identifier used to track related call and session data.
UserId	String	Unique identifier of the user associated with the call.
UserPrincipalName	String	User Principal Name (UPN) of the user who participated in the call.
UserDisplayName	String	Display name of the user who participated in the call.
StartDateTime	Edm.DateTimeOffset	Timestamp indicating when the call started.
InviteDateTime	Edm.DateTimeOffset	Timestamp indicating when the call invitation was sent.
FailureDateTime	Edm.DateTimeOffset	Timestamp indicating when the call failed, if applicable.
EndDateTime	Edm.DateTimeOffset	Timestamp indicating when the call ended.
Duration	Integer	Duration of the call in seconds.
CallType	String	Type of call, such as inbound or outbound.
SuccessfulCall	String	Indicates whether the call was successfully completed.
CallerNumber	String	Phone number of the caller.
CalleeNumber	String	Phone number of the callee.
MediaPathLocation	String	Location of the media path used during the call.
SignalingLocation	String	Location of the signaling server handling the call.
FinalSipCode	Integer	Final SIP (Session Initiation Protocol) response code for the call.
CallEndSubReason	Integer	Detailed subreason code explaining why the call ended.
FinalSipCodePhrase	String	Description of the final SIP code.
MediaBypassEnabled	Boolean	Indicates whether Media Bypass was enabled for the call.
FromDate	Edm.Date	Start date for filtering calls to retrieve.
ToDate	Edm.Date	End date for filtering calls to retrieve.

Displays Public Switched Telephone Network (PSTN) call records in Microsoft Teams.

テーブル固有の情報

Select

カスタムアプリおよびクライアントクレデンシャルを使用する必要があります。Entra ID（Azure AD）アプリケーションの作成 を参照してください。 Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• FromDate は、'=' 演算子をサポートします。
• ToDate は、'=' 演算子をサポートします。

次にクエリの例を示します。

SELECT * FROM PstnCalls WHERE FromDate = '2021-01-01'

SELECT * FROM PstnCalls WHERE FromDate = '2021-01-01' AND ToDate = '2021-02-09'

Note：FromDate およびToDate は必須パラメータであり、指定されていない場合はデフォルトの日付を日付範囲90日で使用します。

Columns

Name	Type	Description
Id	String	Unique identifier for the PSTN (Public Switched Telephone Network) call record.
CallId	String	Identifier for the specific call within Microsoft Teams.
UserId	String	Unique identifier of the user associated with the call.
UserPrincipalName	String	User Principal Name (UPN) of the user who made or received the call.
UserDisplayName	String	Display name of the user involved in the call.
StartDateTime	Edm.DateTimeOffset	Timestamp indicating when the PSTN call started.
EndDateTime	Edm.DateTimeOffset	Timestamp indicating when the PSTN call ended.
Duration	Integer	Total duration of the call in seconds.
Charge	Edm.Double	Monetary charge for the PSTN call.
CallType	String	Type of call, such as inbound or outbound.
Currency	String	Currency in which the charge is calculated.
CallerNumber	String	Phone number of the caller.
CalleeNumber	String	Phone number of the callee.
UsageCountryCode	String	Country code representing where the PSTN usage occurred.
TenantCountryCode	String	Country code for the Microsoft 365 tenant associated with the call.
ConnectionCharge	Edm.Double	One-time connection charge for the PSTN call.
DestinationName	String	Name of the call destination, such as a city or region.
ConferenceId	String	Identifier for the conference when the call is part of a conference session.
LicenseCapability	String	License capability of the user at the time of the call.
InventoryType	String	Type of inventory resource used for the call, such as service numbers or user numbers.
FromDate	Edm.Date	Start date for filtering PSTN call records to retrieve.
ToDate	Edm.Date	End date for filtering PSTN call records to retrieve.

Retrieves the list of users who are members of a specific Microsoft Teams team.

Table Specific Information

Select

The Cloud will use the Microsoft Teams API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client side within the Cloud.

• TeamId supports the '=,IN' operators.

For example, the following query is processed server side:

SELECT * FROM TeamMembers WHERE TeamId = 'f7985bee-7fb4-404d-a954-5ba68ae7c8db'

SELECT * FROM TeamMembers WHERE TeamId IN ('f7985bee-7fb4-404d-a954-5ba68ae7c8db', 'da838338-4e77-4c05-82a6-79d9f0274511')

Columns

Name	Type	Description
Id [KEY]	String	Unique identifier for the team member in Microsoft Teams.
TeamId	String	Identifier of the team to which the member belongs.
DisplayName	String	Full display name of the team member.
email	String	Email address of the team member.
Roles	String	Roles assigned to the team member, such as owner or member.
TenantId	String	Identifier of the Microsoft 365 tenant associated with the team member.
UserId	String	Unique user identifier for the team member.
StartDateTime	Datetime	Timestamp indicating when the membership history for the team started.

Stores real-time presence information for Microsoft Teams users.

Table Specific Information

Select

The Cloud will use the Microsoft Teams API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the Cloud.

• Id supports '=' operator.

Following is an example query:

SELECT * FROM UserPresence WHERE Id = '142478877'

SELECT * FROM UserPresence WHERE Id IN ('0409f710-2aa9-4f05-8944-ef382160f1d1', '04a54c2f-2402-4cee-ac8e-9eee05d0dd30')

Columns

Name	Type	Description
Id	String	Unique identifier for the Microsoft Teams user.
Availability	String	The user's current availability status, such as Available, Away, Busy, or Do Not Disturb.
Activity	String	The user's current activity state in Microsoft Teams, such as In a call, In a meeting, or Presenting.
StatusMessage_ExpiryDateTime_DateTime	String	The date and time when the user's custom status message is set to expire.
StatusMessage_ExpiryDateTime_TimeZone	String	The time zone associated with the expiration date and time of the user's status message.
StatusMessage_Message_Content	String	The text content of the user's custom status message in Microsoft Teams.
StatusMessage_PublishedDateTime	Datetime	The date and time when the user's custom status message was published.

Contains detailed profile, organizational, and directory synchronization information for users in Microsoft Teams, including contact details, licensing, job roles, and Active Directory mappings.

テーブル固有の情報

Select

Users テーブルをクエリします。Cloud は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。

• Id は、'=' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM Users WHERE Id = '08d30c14-2775-45c9-8809-3eca47340959'

Columns

Name	Type	Description
id [KEY]	String	Unique identifier for the user in Microsoft Teams.
deletedDateTime	Datetime	Timestamp indicating when the user account was deleted, if applicable.
accountEnabled	Bool	Indicates whether the user's account is currently enabled.
assignedLicenses	String	List of product licenses currently assigned to the user.
businessPhones	String	Collection of the user's business phone numbers.
city	String	City listed in the user's organizational profile.
companyName	String	Name of the company the user is associated with.
country	String	Country or region specified in the user's profile.
createdDateTime	Datetime	Timestamp when the user account was created.
department	String	Department name listed in the user's organizational information.
displayName	String	Full name displayed for the user in Teams and other services.
employeeHireDate	Datetime	Date the user was hired, according to their employee record.
employeeId	String	Identifier assigned to the user in the employee directory.
employeeOrgData_costCenter	String	Cost center code associated with the user's organizational unit.
employeeOrgData_division	String	Division in which the user is employed within the organization.
employeeType	String	Classification of the user's employment, such as Full-time or Contractor.
givenName	String	The user's first name.
identities	String	Collection of identity records used for sign-in and directory purposes.
imAddresses	String	List of Instant Messaging (IM) addresses associated with the user.
isManagementRestricted	Bool	Indicates whether the user is restricted from being managed by others.
isResourceAccount	Bool	Specifies whether the user account is a resource account.
jobTitle	String	Job title listed in the user's profile.
lastPasswordChangeDateTime	Datetime	Timestamp of the user's most recent password change.
mail	String	Primary email address associated with the user.
mailNickname	String	Nickname used to generate the user's email address.
mobilePhone	String	User's mobile phone number.
officeLocation	String	Office building or physical location assigned to the user.
onPremisesDistinguishedName	String	User's distinguished name in the on-premises Active Directory.
onPremisesDomainName	String	Name of the on-premises domain the user is associated with.
onPremisesExtensionAttributes_extensionAttribute1	String	Custom extension attribute 1 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute10	String	Custom extension attribute 10 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute11	String	Custom extension attribute 11 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute12	String	Custom extension attribute 12 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute13	String	Custom extension attribute 13 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute14	String	Custom extension attribute 14 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute15	String	Custom extension attribute 15 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute2	String	Custom extension attribute 2 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute3	String	Custom extension attribute 3 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute4	String	Custom extension attribute 4 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute5	String	Custom extension attribute 5 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute6	String	Custom extension attribute 6 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute7	String	Custom extension attribute 7 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute8	String	Custom extension attribute 8 from the on-premises Active Directory for the user.
onPremisesExtensionAttributes_extensionAttribute9	String	Custom extension attribute 9 from the on-premises Active Directory for the user.
onPremisesImmutableId	String	Unique, immutable identifier used to map the user to an on-premises Active Directory object.
onPremisesLastSyncDateTime	Datetime	Timestamp of the last directory synchronization from on-premises Active Directory to Microsoft 365.
onPremisesProvisioningErrors	String	Collection of errors encountered during the on-premises provisioning process for the user.
onPremisesSamAccountName	String	Security Account Manager (SAM) account name of the user in the on-premises Active Directory.
onPremisesSecurityIdentifier	String	Security Identifier (SID) associated with the user's on-premises Active Directory account.
onPremisesSyncEnabled	Bool	Indicates whether synchronization with the on-premises directory is enabled for the user.
onPremisesUserPrincipalName	String	User Principal Name (UPN) of the user in the on-premises environment.
otherMails	String	Collection of additional email addresses associated with the user.
passwordProfile_forceChangePasswordNextSignIn	Bool	Indicates whether the user must change their password at the next sign-in.
passwordProfile_forceChangePasswordNextSignInWithMfa	Bool	Indicates whether the user must change their password at the next sign-in using multi-factor authentication.
passwordProfile_password	String	Password value to set during user creation.
postalCode	String	Postal code or ZIP code listed in the user's address information.
preferredLanguage	String	The user's preferred language, typically used for localization and communication settings.
serviceProvisioningErrors	String	List of errors encountered during the provisioning of services for the user.
state	String	State or province listed in the user's address details.
streetAddress	String	Street-level address of the user's physical or mailing location.
surname	String	User's family name or last name.
userPrincipalName	String	The user's sign-in name, usually formatted as an email address.
userType	String
Authentication_id	String	Unique identifier for the user's authentication container.
Calendar_id	String	Unique identifier for the user's calendar.
Drive_id	String	Unique identifier for the user's OneDrive drive.
InferenceClassification_id	String	Unique identifier for the user's email classification preferences.
Insights_id	String	Unique identifier for insights related to the user, such as activity and collaboration data.
Manager_id	String	Identifier for the user's manager in the organizational directory.
Onenote_id	String	Unique identifier for the user's OneNote data container.
Outlook_id	String	Unique identifier for the user's Outlook data container.
Photo_id	String	Identifier for the user's profile photo resource.
Planner_id	String	Identifier for the user's Microsoft Planner resource.
Presence_id	String	Identifier for the user's presence data in Microsoft Teams.
Settings_id	String	Identifier for the user's settings container.
Teamwork_id	String	Identifier for the user's Microsoft Teams collaboration container.
Todo_id	String	Identifier for the user's Microsoft To Do task list.

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

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

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

Name	Description
ArchiveTeam	Archives a specified Microsoft Team, preserving content in read-only mode while preventing further edits or changes.
CreateChat	Initiates a one-on-one or group chat in Teams by specifying participants and chat metadata.
DeleteChat	Permanently removes a Teams chat thread, including all associated messages and metadata.
DeleteChatMessage	Deletes a specific message from a Teams chat, identified by message ID and chat context.
DeleteMessage	Removes a message from a Teams channel conversation, typically used for moderation or compliance.
FetchAdditionalUserFields	Pulls extended profile data (T1, T2, T3 fields) for a specific Teams user for reporting or personalization.
GetAdminConsentURL	Creates a secure admin authorization link for granting delegated or application permissions to Teams-based apps.
GetAttachmentContentUrl	Retrieves a direct-access URL for a file attachment from a Teams chat message for downloading or embedding.
GetUserActivityCount	Returns statistics on user engagement in Teams, broken down by activities like chat messages, meeting participation, and calls.
SendChatMessage	Sends a new message to a specified chat thread in Microsoft Teams, supporting text and rich content.
SendMessage	Posts a message to a Teams channel, optionally including formatting, mentions, and embedded content.
ShareSchedule	Publishes pending changes in a Teams schedule, such as shifts or time-off entries, making them visible to team members.
UnArchiveTeam	Reactivates an archived Microsoft Team, restoring full editing capabilities and collaboration access.
UpdateChat	Modifies properties of a Teams chat, such as adding participants or changing the topic name.
UpdateChatMessage	Updates the content of an existing Teams chat message, allowing corrections or content changes.
UpdateMessage	Revises an existing message in a Teams channel to reflect new information or correct errors.

Archives a specified Microsoft Team, preserving content in read-only mode while preventing further edits or changes.

Input

Name	Type	Required	Description
TeamId	String	True	Unique identifier of the Microsoft Team that will be archived.
ShouldSetSPOSiteReadOnlyForMembers	String	False	Optional flag indicating whether to restrict team members' access to read-only on the associated SharePoint Online site. If set to false or omitted, permissions remain unchanged.

Result Set Columns

Name	Type	Description
Status	String	Indicates the result of the archive operation, such as success or failure.

Initiates a one-on-one or group chat in Teams by specifying participants and chat metadata.

Input

Name	Type	Required	Description
ChatType	String	True	Defines the type of chat to create. Valid values are group for multi-user conversations and oneOnOne for direct messages between two users.
Members	String	True	Comma-separated list of user IDs to include in the chat. Ensure each user ID is valid and separated by a comma and a space.
Topic	String	False	Optional title for the chat. Only applicable if the chat type is group; ignored for oneOnOne chats.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the chat creation process completed successfully.

Permanently removes a Teams chat thread, including all associated messages and metadata.

Input

Name	Type	Required	Description
ChatId	String	True	Unique identifier of the chat to be deleted. This must reference an existing oneOnOne or group chat.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the chat deletion was completed successfully.

Deletes a specific message from a Teams chat, identified by message ID and chat context.

Input

Name	Type	Required	Description
UserId	String	True	Unique identifier of the user attempting to delete the message. Used to verify permissions and track audit logs.
ChatId	String	True	Unique identifier of the chat where the message was posted. Helps locate the message within the correct conversation.
MessageId	String	True	Unique identifier of the message to be deleted. Required to accurately target the message within the chat.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the message was successfully deleted from the chat. Returns true if successful, false otherwise.

Removes a message from a Teams channel conversation, typically used for moderation or compliance.

Input

Name	Type	Required	Description
TeamId	String	True	Unique identifier of the team where the message exists. Used to ensure the operation targets the correct Microsoft Teams environment.
ChannelId	String	True	Unique identifier of the channel within the team where the message is posted. Required to locate the message contextually.
MessageId	String	True	Unique identifier of the message to be deleted. Ensures precise targeting of the message in the specified channel.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the message was successfully deleted. Returns true if the deletion was successful, otherwise false.

Pulls extended profile data (T1, T2, T3 fields) for a specific Teams user for reporting or personalization.

Input

Name	Type	Required	Description
UserId	String	True	Unique identifier of the user whose additional information is being requested. Required to scope the data fetch.
IncludeFields	String	False	Comma-separated list of specific user fields to include in the result. Example: jobTitle, department, location.
ExcludeFields	String	False	Comma-separated list of specific user fields to exclude from the result. Example: mobilePhone, officeLocation.

Result Set Columns

Name	Type	Description
*	String	Complete set of user data returned by the query, shaped according to the include and exclude filters applied.

Creates a secure admin authorization link for granting delegated or application permissions to Teams-based apps.

Input

Name	Type	Required	Description
CallbackUrl	String	False	The URL to which the user is redirected after granting admin consent. This must exactly match the Reply URL configured in the Azure Active Directory app registration.
State	String	False	Opaque string value used to maintain state between the request and callback. Useful for preventing cross-site request forgery attacks and preserving user session.
Scope	String	False	Space-separated list of permissions the application is requesting admin consent for. Example: User.Read Group.ReadWrite.All Directory.Read.All. デフォルト値はhttps://graph.microsoft.com/group.read.all https://graph.microsoft.com/group.readwrite.all https://graph.microsoft.com/user.read.all https://graph.microsoft.com/appcatalog.readwrite.all https://graph.microsoft.com/presence.read.all https://graph.microsoft.com/chat.read https://graph.microsoft.com/channelmessage.read.all https://graph.microsoft.com/chat.readbasic https://graph.microsoft.com/chat.readwriteです。

Result Set Columns

Name	Type	Description
URL	String	Generated authorization URL that must be opened in a browser to prompt the admin for consent and obtain the verifier token.

Retrieves a direct-access URL for a file attachment from a Teams chat message for downloading or embedding.

Input

Name	Type	Required	Description
ChatId	String	True	Unique identifier of the chat that contains the message with the attachment. Used to locate the context of the request.
AttachmentId	String	False	Unique identifier of the attachment whose content URL is being retrieved. This field is not server-side filterable.

Result Set Columns

Name	Type	Description
ContentUrl	String	Direct URL to access the attachment content that was shared in the specified chat.
Success	String	Indicates whether the operation to retrieve the attachment content URL was successful. Returns true if successful, false otherwise.

Returns statistics on user engagement in Teams, broken down by activities like chat messages, meeting participation, and calls.

Input

Name	Type	Required	Description
Duration	String	True	Number of days to include in the user activity report. Determines the reporting period for activity data. 使用できる値は次のとおりです。D7, D30, D90, D180
FileLocation	String	False	Full path where the downloaded CSV report should be saved. Used when writing the report directly to disk.
Encoding	String	False	Text encoding format used for the output report file. Examples include UTF-8, ASCII, or UTF-16. 使用できる値は次のとおりです。NONE, BASE64 デフォルト値はBASE64です。

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the report was generated successfully. Returns true if successful, false otherwise.
FileData	String	Contains the full contents of the generated report file if FileLocation and FileStream are not provided.

Sends a new message to a specified chat thread in Microsoft Teams, supporting text and rich content.

Input

Name	Type	Required	Description
ChatId	String	True	Unique identifier of the chat where the message is sent. Required to route the message to the correct conversation.
ContentType	String	False	Format of the message content to be sent. Common values include text, html, and markdown.
Content	String	True	Main body of the message to be sent in the chat, formatted according to the specified ContentType.
Importance	String	False	Priority level of the message. Supported values include low, normal, and high. Default is normal. 使用できる値は次のとおりです。normal, high, urgent
Mention	String	False	Comma-separated MentionText and MentionUserId pairs. For multiple mentions, use semicolons to separate pairs. Example: MentionText1, MentionUserId1; MentionText2, MentionUserId2.
Attachment	String	False	Comma-separated AttachmentContentType and AttachmentContentUrl pairs. For multiple attachments, use semicolons to separate pairs. Example: AttachmentContentType1, AttachmentContentUrl1; AttachmentContentType2, AttachmentContentUrl2.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the message was successfully sent to the chat. Returns true if successful, false otherwise.

Posts a message to a Teams channel, optionally including formatting, mentions, and embedded content.

Input

Name	Type	Required	Description
TeamId	String	True	Unique identifier of the team where the message is sent. Required to route the message to the correct Microsoft Teams group.
ChannelId	String	True	Unique identifier of the channel within the team where the message is posted.
MessageId	String	False	Unique identifier of the message to be updated. Used when modifying an existing message.
ContentType	String	False	Format of the message content. Common values include text, html, and markdown.
Content	String	True	Body of the message to be sent or updated in the specified channel, formatted according to the ContentType.
Importance	String	False	Priority level of the message. Accepted values include low, normal, and high. The default value is normal. 使用できる値は次のとおりです。normal, high, urgent
Mention	String	False	Comma-separated MentionText and MentionUserId pairs. For multiple mentions, use semicolons to separate each pair. Example: MentionText1, MentionUserId1; MentionText2, MentionUserId2.
Attachment	String	False	Comma-separated AttachmentContentType and AttachmentContentUrl pairs. For multiple attachments, use semicolons to separate each pair. Example: AttachmentContentType1, AttachmentContentUrl1; AttachmentContentType2, AttachmentContentUrl2.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the message was successfully sent or updated. Returns true if the operation completed successfully, otherwise false.

Publishes pending changes in a Teams schedule, such as shifts or time-off entries, making them visible to team members.

Input

Name	Type	Required	Description
TeamId	String	True	Unique identifier of the team whose schedule is being shared. Required to target the correct Microsoft Teams group.
NotifyTeam	String	True	Specifies whether to notify the entire team or only the users with assigned shifts. If true, all team members receive a visible notification.
StartDateTime	String	True	Start date and time from which to share shifts on the team's schedule. Defines the beginning of the sharing window.
EndDateTime	String	True	End date and time until which shifts are shared on the schedule. Defines the end of the sharing window.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the schedule was successfully shared. Returns true if successful, otherwise false.

Reactivates an archived Microsoft Team, restoring full editing capabilities and collaboration access.

Input

Name	Type	Required	Description
TeamId	String	True	Unique identifier of the Microsoft Teams team that should be restored from an archived state.

Result Set Columns

Name	Type	Description
Status	String	Indicates whether the unarchive operation was successful. Returns a status message or code reflecting the result.

Modifies properties of a Teams chat, such as adding participants or changing the topic name.

Input

Name	Type	Required	Description
ChatId	String	True	Unique identifier of the chat to be updated. Required to locate the chat instance.
Topic	String	True	New title for the chat. This value can only be set if the chat is a group chat, not a one-on-one conversation.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the chat update operation was successful. Returns true if the update completed without errors.

Updates the content of an existing Teams chat message, allowing corrections or content changes.

Input

Name	Type	Required	Description
ChatId	String	True	Unique identifier of the chat that contains the message to be updated. Required to locate the correct conversation.
MessageId	String	True	Unique identifier of the message to be updated within the specified chat.
ContentType	String	False	Format of the message content. Supported values include text, html, and markdown.
Content	String	False	New content to replace the existing message body. Must match the specified ContentType.
Importance	String	False	Priority level of the message. Accepted values include low, normal, and high.
Mention	String	False	Comma-separated MentionText and MentionUserId pairs. For multiple mentions, use semicolons to separate pairs. Example: MentionText1, MentionUserId1; MentionText2, MentionUserId2.
PolicyViolation	String	False	JSON object defining the properties of a policy violation. Only applicable when the update is performed using application permissions.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the message update operation was successful. Returns true if completed without errors.

Revises an existing message in a Teams channel to reflect new information or correct errors.

Input

Name	Type	Required	Description
TeamId	String	True	Unique identifier of the Microsoft Teams team that contains the message to be updated.
ChannelId	String	True	Unique identifier of the channel within the specified team where the message is located.
MessageId	String	True	Unique identifier of the message to be updated within the specified channel.
ContentType	String	False	Format of the message content. Accepted values include text, html, and markdown.
Content	String	False	New content that replaces the current message body. Must be compatible with the specified ContentType.
Importance	String	False	Priority level of the message. Valid values include low, normal, and high.
Mention	String	False	Comma-separated MentionText and MentionUserId pairs. For multiple mentions, use semicolons to separate pairs. Example: MentionText1, MentionUserId1; MentionText2, MentionUserId2.
PolicyViolation	String	False	JSON object describing the properties of a policy violation. Required only when using application permissions and enforcing compliance rules.

Result Set Columns

Name	Type	Description
Success	String	Indicates whether the message update operation completed successfully. Returns true if the update was successful, otherwise false.

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

スキーマテーブル

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

• 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：バッチ処理または単一の更新に関する情報を返す。

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

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

SELECT * FROM sys_catalogs

Columns

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

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

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

          SELECT * FROM sys_schemas
          

Columns

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

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

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

          SELECT * FROM sys_tables
          

Columns

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

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

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

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

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 から返されたフィールドがテーブルの主キーであるかどうか。
ColumnType	String	スキーマ内のカラムの役割または分類。可能な値は、SYSTEM、LINKEDCOLUMN、NAVIGATIONKEY、REFERENCECOLUMN、およびNAVIGATIONPARENTCOLUMN が含まれます。

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

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

          SELECT * FROM sys_procedures
          

Columns

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

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

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

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

パラメータに加えて結果セットのカラムを含めるには、IncludeResultColumns 擬似カラムをTrue に設定します。

SELECT * FROM sys_procedureparameters WHERE ProcedureName = 'SendMail' AND IncludeResultColumns='True'

Columns

Name	Type	Description
CatalogName	String	ストアドプロシージャを含むデータベースの名前。
SchemaName	String	ストアドプロシージャを含むスキーマの名前。
ProcedureName	String	パラメータを含むストアドプロシージャの名前。
ColumnName	String	ストアドプロシージャパラメータの名前。
Direction	Int32	パラメータのタイプに対応する整数値：input (1)。input/output (2)、またはoutput(4)。input/output タイプパラメータは、入力パラメータと出力パラメータの両方になれます。
DataType	Int32	データ型を示す整数値。この値は、実行時に環境に基づいて決定されます。
DataTypeName	String	データ型の名前。
NumericPrecision	Int32	数値データの場合は最大精度。文字データおよび日時データの場合は、カラムの長さ（文字数）。
Length	Int32	文字データの場合は、許可される文字数。数値データの場合は、許可される桁数。
NumericScale	Int32	数値データの小数点以下の桁数。
IsNullable	Boolean	パラメータがNull を含められるかどうか。
IsRequired	Boolean	プロシージャの実行にパラメータが必要かどうか。
IsArray	Boolean	パラメータが配列かどうか。
Description	String	パラメータの説明。
Ordinal	Int32	パラメータのインデックス。
Values	String	このパラメータで設定できる値は、このカラムに表示されるものに限られます。指定できる値はカンマ区切りです。
SupportsStreams	Boolean	パラメータがファイルを表すかどうか。ファイルは、ファイルパスとして渡すことも、ストリームとして渡すこともできます。
IsPath	Boolean	パラメータがスキーマ作成操作のターゲットパスかどうか。
Default	String	何も値が指定されていない場合に、このパラメータで使用される値。
SpecificName	String	複数のストアドプロシージャが同じ名前を持つ場合、それぞれの同名のストアドプロシージャを一意に識別するラベル。特定の名前を持つプロシージャが1つだけの場合は、その名前がここに単純に反映されます。
IsCDataProvided	Boolean	プロシージャがネイティブのMicrosoft Teams プロシージャではなく、CData によって追加 / 実装されているかどうか。

Pseudo-Columns

Name	Type	Description
IncludeResultColumns	Boolean	出力にパラメータに加えて結果セットのカラムを含めるかどうか。デフォルトはFalse です。

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

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

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

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	主キーのカラム名。

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

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

         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	外部キーがインポート（他のテーブルを指す）キーかエクスポート（他のテーブルから参照される）キーかを指定します。

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

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

         SELECT * FROM sys_primarykeys
          

Columns

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

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

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

          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	インデックスのカラムのシーケンスナンバー。

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

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

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	プロパティに関するその他のさまざまな情報。

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 構文の詳細。

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

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

         SELECT * FROM sys_identity
          

Columns

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

利用可能なシステム情報を説明します。

次のクエリは、すべてのカラムを取得します。

SELECT * FROM sys_information

Columns

Name	Type	Description
Product	String	製品名。
Version	String	製品のバージョン番号。
Datasource	String	製品が接続するデータソースの名前。
NodeId	String	製品がインストールされているマシンの固有識別子。
HelpURL	String	製品のヘルプドキュメントのURL。
License	String	製品のライセンス情報。（この情報が利用できない場合、この項目は空白のままか「N/A」と表示されます。）
Location	String	製品のライブラリが格納されているファイルパスの場所。
Environment	String	製品が現在稼働している環境またはランタイムのバージョン。
DataSyncVersion	String	本コネクタを使用するために必要なCData Sync のティア。
DataSyncCategory	String	CData Sync 機能のカテゴリ（例：Source、Destination）。

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

Authentication

---

プロパティ	説明
AuthScheme	Microsoft Teams に接続する際に使用する認証の種類を指定します。このプロパティが空白の場合は、デフォルトの認証が使用されます。
DefaultGroups	Determines whether to use the /me/memberOf or /groups endpoint for user authentication.
DefaultUser	Determines whether to use the /me or /users endpoint for user authentication.
MsAppActsAsUserId	Specifies the Microsoft Entra ID (GUID) of the user the application should impersonate when authenticating with a service principal.

Azure Authentication

---

プロパティ	説明
AzureTenant	データにアクセスするために使用されているMicrosoft Teams テナントを識別します。テナントのドメイン名（例： contoso.onmicrosoft.com ）またはディレクトリ（テナント）ID のいずれかを受け付けます。
AzureEnvironment	接続するAzure ネットワーク環境を指定します。Azure アカウントが追加されたネットワークと同じである必要があります。

OAuth

---

プロパティ	説明
OAuthClientId	カスタムOAuth アプリケーションに割り当てられたクライアントID（コンシューマーキーとも呼ばれます）を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。
OAuthClientSecret	カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタムOAuth アプリケーションのみ）
Scope	データへの適切なアクセスを確実にするために、認証ユーザーのアプリケーションへのアクセス範囲を指定します。 カスタムOAuth アプリケーションが必要な場合は、通常、アプリケーションの作成時に指定します。

JWT OAuth

---

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

SSL

---

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

Logging

---

プロパティ	説明
Verbosity	ログファイルのVerbosity レベルを指定し、記録される情報の詳細度を制御します。サポートされる値の範囲は1から5までです。

Schema

---

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

Miscellaneous

---

プロパティ	説明
GroupId	Specify a default GroupId.
IncludeAllGroups	Specifies whether the provider returns all Microsoft 365 Groups in your organization or only those the authenticated user is a member of.
MaxRows	集計やGROUP BY を含まないクエリで返される最大行数を指定します。
Pagesize	Specifies the maximum number of records the provider retrieves per page when querying Microsoft Teams data.
PseudoColumns	テーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。
Timeout	provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。
UserId	Specify a default UserId.

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

---

プロパティ	説明
AuthScheme	Microsoft Teams に接続する際に使用する認証の種類を指定します。このプロパティが空白の場合は、デフォルトの認証が使用されます。
DefaultGroups	Determines whether to use the /me/memberOf or /groups endpoint for user authentication.
DefaultUser	Determines whether to use the /me or /users endpoint for user authentication.
MsAppActsAsUserId	Specifies the Microsoft Entra ID (GUID) of the user the application should impersonate when authenticating with a service principal.

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

Possible Values

AzureAD, AzureServicePrincipal, AzureServicePrincipalCert

データ型

string

デフォルト値

"AzureAD"

解説

AuthScheme には以下が含まれます。

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

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

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

Determines whether to use the /me/memberOf or /groups endpoint for user authentication.

Possible Values

AllGroups, CurrentUser

データ型

string

デフォルト値

"CurrentUser"

解説

Determines whether to use the /me/memberOf or /groups endpoint for user authentication.

Supported values are:

• CurrentUser: Uses the /me/memberOf endpoint for user authentication.
• AllGroups: Uses the /groups endpoint for user authentication.