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

Confluence への接続

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

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

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

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

Confluence への接続

任意のConfluence Cloud またはConfluence Server インスタンスへの接続を確立できます。接続するにはURL 接続プロパティを設定します。例えば、https://yoursitename.atlassian.net です。

Confluence への認証

Confluence は、次の認証メソッドをサポートしています：API トークン、Basic 認証、OAuth 2.0、SSO。

API トークン

Confluence Cloud アカウント

トークンの取得

アカウント認証にはAPI トークンが必要です。API トークンを生成するには、Atlassian アカウントにログインしてAPI トークン -> API トークンの作成を選択します。生成されたトークンが表示されます。

トークンを使用する認証

Cloud アカウントへの認証を行うには、以下を入力します（Note：Password はCloud アカウントへの接続には非推奨となり、Server インスタンスへの接続にのみ使用されるようになりました）。

• AuthScheme：APIToken に設定。
• User：Confluence サーバーに認証する際に使用されるユーザー。
• APIToken：現在認証されているユーザーに紐づくAPI トークン。
• Url：Confluence エンドポイントに紐づくURL。例えば、https://yoursitename.atlassian.net です。

Basic 認証

Confluence Server インスタンス

Server インスタンスへの認証を行うには、以下のように指定します。

• AuthScheme：Basic に設定。
• User：Confluence インスタンスに認証する際に使用されるユーザー。
• Password：Confluence サーバーに認証する際に使われるパスワード。
• Url：Confluence エンドポイントに紐づくURL。例えば、https://yoursitename.atlassian.net です。

OAuth

すべての場合で、AuthScheme をOAuth に、Scope をアプリケーション設定で取得した値に設定する必要があります。以下に説明するすべてのフローは、すでに設定済みであることを前提として書かれています。 Note： Confluence Cloud では OAuth 1.0 は非推奨です。ホストされているConfluence ユーザーのみが使用するようにしてください。

Crowd

AuthScheme をCrowd に設定し、次の接続プロパティを設定します。

• User：Crowd ユーザーアカウント。
• Password：Crowd アカウントに関連付けられたパスワード。
• SSOLoginURL：Crowd アカウントに関連付けられたログインURL。IDP URL は、自身のアプリケーション->［SSO］->［SSO information］->［Identity provider single sign-on URL］にあります。
• SSOAppName：SSO を有効にするアプリケーション名。
• SSOAppPassword：SSO を有効にするアプリケーションのパスワード。
• SSOExchangeUrl：The URL used used to exchange the SAML token for Confluence cookies. This URL may have the following formats:
  • https://<authority of Confluence instance>/plugins/servlet/samlconsumer
  • https://<authority of Confluence instance>/plugins/servlet/samlsso

接続文字列の例：

AuthScheme=Crowd;Url=https://yoursitename.atlassian.net;SSOLoginURL='https://<authority>/crowd/console/secure/saml/sso.action';User=crowdUserName;Password=crowdPassword;SSOExchangeUrl=https://<authority of Confluence instance>/plugins/servlet/samlconsumer;SSOAppName=CrowdAppName;SSOAppPassword=CrowdAppPassword;

Okta

Okta に接続するには、AuthScheme をOkta に設定し、次のプロパティを設定します。

• User：Okta ユーザー。
• Password：Okta ユーザーのパスワード。
• SSOLoginURL：SSO プロバイダーのログインURL。
• SSOExchangeUrl: The URL used used to exchange the SAML token for Confluence cookies. This URL may have the following formats:
  • https://<authority of Confluence instance>/plugins/servlet/samlconsumer
  • https://<authority of Confluence instance>/plugins/servlet/samlsso

Okta クライアントリクエストコンテキストをオーバーライドする信頼されたアプリケーションまたはプロキシを使用する場合、またはMFA を設定している場合は、Okta を使用して認証するためにSSOProperties を組み合わせて使用する必要があります。必要に応じて、以下のいずれかを設定します。

• APIToken：Okta クライアントリクエストコンテキストをオーバーライドする、信頼されたアプリケーションまたはプロキシ経由でユーザーを認証する場合、これを顧客がOkta 組織で作成したAPI Token に設定します。
• MFAType：MFA フローを設定した場合、次の対応するタイプのいずれかに設定します：OktaVerify、Email、またはSMS。
• MFAPassCode：MFA フローを設定した場合は、有効なパスコードに設定します。
  これを空欄または無効な値に設定した場合、Cloud はユーザーのデバイスまたはE メールにワンタイムパスワードチャレンジを発行します。パスコードを受信後、取得したワンタイムパスワードをMFAPassCode 接続プロパティに設定する接続を再度開きます。
• MFARememberDevice：デフォルトはTrue です。Okta は、MFA が必要な場合にデバイスを記憶させることをサポートします。設定された認証ポリシーに従ってデバイスの記憶が許可されている場合、Cloud はMFA 認証の有効期間を延長するデバイストークンを送信します。MFA を記憶させない場合は、この 変数をFalse に設定してください。

接続文字列の例：

AuthScheme=Okta;Url=https://yoursitename.atlassian.net;SSOLoginURL='https://example.okta.com/home/appType/0bg4ivz6cJRZgCz5d6/46';User=oktaUserName;Password=oktaPassword;SSOExchangeUrl=https://<authority of Confluence instance>/plugins/servlet/samlconsumer;

If you do not have access to the user name and API token or do not wish to require them, you can use OAuth authentication. Confluence uses the OAuth authentication standard, which requires the authenticating user to interact with Confluence via the browser. Please note OAuth 2.0 only is supported for Confluence Cloud.

Create an OAuth App

To obtain the OAuth client credentials, consumer key, and consumer secret:

1. Log in to your Confluence Cloud site.
2. Navigate to your application management (https://developer.atlassian.com/apps/).
3. Select Create new app, then name the application. The application is created.
4. If missing, add OAuth 2.0 functionality to your application by navigating to APIS AND FEATURES > + Add > Add OAuth 2.0 (3LO).
5. From APIS AND FEATURES > + Add, add the Confluence platform REST API to your application. Please note that you also need to add the Confluence application to get all of the functionalities of the driver.
6. From APIS AND FEATURES > + Confluence platform REST API, add the desired scopes to your application.
7. You also need to set your Callback URL. Navigate to APIS AND FEATURES > OAuth 2.0 (3LO). Enter a URL that is accessible to your applicationand save the changes.

Fine Tuning Data Access

You can use the following properties to gain more control over the data returned from Confluence:

• IncludeArchivedSpaces: Include content from archived spaces in the result. This defaults to false.
• SpaceKey: Search results will only display contents from the specified space.
• Timezone: The timezone of the Confluence instance. The appropriate datetime filters will be used to retrieve results in accordance with the specified timezone.

SSL 設定のカスタマイズ

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

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

クライアントSSL 証明書

Confluence Cloud はクライアント証明書の設定もサポートしています。次を設定すれば、クライアント証明書を使って接続できます。

• SSLClientCert：クライアント証明書のための証明書ストア名。
• SSLClientCertType：TLS / SSL クライアント証明書を格納するキーストアの種類。
• SSLClientCertPassword：TLS / SSL クライアント証明書のパスワード。
• SSLClientCertSubject：TLS / SSL クライアント証明書のサブジェクト。

Firewall またはProxy 経由の接続

HTTP プロキシ

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

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

その他のプロキシ

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

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

Overview

This section shows the available API objects and provides more information on executing SQL to Confluence APIs.

Key Features

• The Cloud models Confluence entities like pages, blogposts, comments, attachments, spaces, audit records and users as relational views, allowing you to write SQL to query Confluence data.
• Live connectivity to these objects means any changes to your Confluence account are immediately reflected when using the Cloud.

Views

ビュー describes the available views. Views are statically defined to model AuditRecords, Pages, Blogposts, Comments, Attachments, Contributors, Labels, Spaces and Users.

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

CData Cloud - Confluence テーブル

Name	Description
Pages	Generated schema file.

Generated schema file.

Table Specific Information

Select

The Cloud will use the Confluence 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. You can also search for Attachments using CQL (Confluence Query Language).

• Id supports the '=,!=,IN,NOT IN' comparisons.
• Type supports the '=,!=,IN,NOT IN' comparisons.
• Title supports the '=,!=,LIKE,NOT LIKE,IN,NOT IN' comparisons.
• SpaceKey supports the '=,!=,IN,NOT IN' comparisons.
• SpaceType supports the '=,!=,IN,NOT IN' comparisons.
• CreatedByUserName supports the '=,!=,IN,NOT IN' comparisons.
• CreatedDate supports the '=,!=,>,>=,<,<=' comparisons.
• LastUpdatedDatetime supports the '=,!=,>,>=,<,<=' comparisons.

For example, the following queries are processed server side:

SQL

SELECT * FROM Pages WHERE Id = '1234'

SELECT * FROM Pages WHERE Id IN ('1234', '2345')

SELECT * FROM Pages WHERE Id = '294922' OR Type = 'page'

SELECT * FROM Pages WHERE CreatedDate <= '2019/03/29 15:00' AND Id IN ('1234', '2345')

Additionally Id, Type, Title, CreatedDate, CreatedByUserName, AND LastUpdatedDatetime columns can be used in the ORDER BY clause, as following:

SELECT * FROM Pages ORDER BY Id DESC

SELECT * FROM Pages ORDER BY CreatedByUserName ASC

CQL

Note: Filtering with CQL has the highest priority and all the other filters except "Excerpt" will be ignored when CQL filter is present in the query.

SELECT * FROM Pages WHERE CQL = 'creator = currentUser() AND content = "1234" OR space.type = "global"'

Columns

Name	Type	ReadOnly	References	SupportedOperators	Description
Id [KEY]	String	False		=,!=,IN,NOT IN	Id of the content.
Type	String	True		=,!=,IN,NOT IN	Type of the content.
Title	String	False		=,!=,IN,NOT IN,LIKE	Title of the content.
Status	String	False		=,IN	Status of the content.
Storage	String	False			The body content storage of the page..
AtlasDocFormat	String	False			The body content in atlas doc format of the page.
Position	Integer	True			Position of the content.
OwnerId	String	False			Id of the owner of the page.
ParentId	Long	False			The Id of the parent page.
SpaceId	String	False		=,!=,IN,NOT IN	The Id of the space the page rests.
SpaceKey	String	True	Spaces.Key	=,!=,IN,NOT IN	The key of the space that the content belongs to.
SpaceType	String	True	Spaces.Type	=,!=,IN,NOT IN	The type of the space that the content belongs to.
Position	String	True			Position of the content.
URL	String	True			URL of the content.
Excerpt	String	True			Excerpt of the content.
IsLatest	Boolean	True			Indicator if this is the latest version of the content.
CreatedByUserName	String	True		=,!=,IN,NOT IN	Username of the user who created the content.
CreatedByUserType	String	True			Type of the user who created the content.
CreatedDate	Datetime	True		=,>,>=,<,<=	Datetime for the creation of the content.
LastUpdatedDatetime	Datetime	True		=,>,>=,<,<=	Datetime of the last updated version of the content.
LastUpdatedMessage	String	True			Message of the last updated version.
LastUpdatedNumber	Integer	True			Number of the last updated version.
LastUpdatedUserName	String	True			Username of the user who updated the latest version.
LastUpdatedUserType	String	True			Type of the user who updated the latest version.
LastUpdatedIsMinorEdit	Boolean	True			Indicator if this version is a minor edit.
LastUpdatedIsHidden	Boolean	True			Indicator if the last updated version is hidden or not.
PreviousVersionUserName	String	True			Username of the user who updated the previous version.
PreviousVersionUserType	String	True			Type of the user who updated the previous version.
PreviousVersionDatetime	Datetime	True			Datetime when the previous version was edited.
PreviousVersionMessage	String	True			Message for the previously edited version.
PreviousVersionNumber	String	True			Number of the previously edited version.
PreviousVersionIsMinorEdit	Boolean	True			Indicator if the previous version was a minor edit.
PreviousVersionIsHidden	Boolean	True			Indicator if the previous version was hidden or not.
VersionUserName	String	True			Username of the user who updated the previous version.
VersionUserType	String	True			Type of the user who updated the previous version.
VersionDatetime	Datetime	True			Datetime when the previous version was edited.
VersionMessage	String	False			Message for the previously edited version.
VersionNumber	Integer	False			Number of the previously edited version.
VersionIsMinorEdit	Boolean	True			Indicator if the previous version was a minor edit.
VersionIsHidden	Boolean	True			Indicator if the previous version was hidden or not.
LinksEditui	String	True			The LinksEditui of the page content.
LinksSelf	String	True			The LinksSelf of the content.
LinksTinyui	String	True			The LinksTinyui of the content.
LinksWebui	String	True			The LinksWebui of the content.
ItemURL	String	True			The URL reference of the element in UI.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name	Type	Description
CQL	String	CQL (Confluence Query Language) allows you to build structured queries.

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

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

CData Cloud - Confluence ビュー

Name	Description
Attachments	Get information about a specific attachment.
AuditRecords	Fetch a paginated list of AuditRecord instances dating back to a certain time.
Blogposts	Get information about a specific blogpost.
Comments	Get information about a specific comment.
Contributors	Get information about the users who have contributed to the content.
GroupMembers	Get users of a specific group.
Groups	Get information about a specific group.
GroupsContentRestrictions	Retrieve information related to the groups restrictions applied to a certain content. The maximum number of restrictions per operation is limited to 200. ContentId is required.
Labels	Get information about the labels that a specific content has.
PageAncestors	To look at a page hierarchy including who is the parent page.
PageChildrens	To look at a page hierarchy including who is the child page.
PageComments	Get comments specific to a page.
PageContents	Get content from the page.
SpacePermissions	Returns space permissions for the specified space(s).
Spaces	Returns information about a number of spaces.
Tasks	Get information regarding tasks.
Users	Get information about a user identified.
UsersContentRestrictions	Retrieve information related to the users restrictions applied to a certain content. The maximum number of restrictions per operation is limited to 200. ContentId is required.
ViewersAnalytics	Get the total number of distinct viewers a piece of content has.
ViewsAnalytics	Get the total number of views a piece of content has.

Get information about a specific attachment.

Table Specific Information

Select

The Cloud will use the Confluence 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. You can also search for Attachments using CQL (Confluence Query Language).

• Id supports the '=,!=,IN,NOT IN' comparisons.
• Type supports the '=,!=,IN,NOT IN' comparisons.
• Title supports the '=,!=,LIKE,NOT LIKE,IN,NOT IN' comparisons.
• SpaceKey supports the '=,!=,IN,NOT IN' comparisons.
• SpaceType supports the '=,!=,IN,NOT IN' comparisons.
• CreatedByUserName supports the '=,!=,IN,NOT IN' comparisons.
• CreatedDate supports the '=,!=,>,>=,<,<=' comparisons.
• LastUpdatedDatetime supports the '=,!=,>,>=,<,<=' comparisons.

For example, the following queries are processed server side:

SQL

SELECT * FROM Attachments WHERE Id = '1234'

SELECT * FROM Attachments WHERE Id IN ('1234', '2345')

SELECT * FROM Attachments WHERE Id = '294922' OR Type = 'attachment'

SELECT * FROM Attachments WHERE CreatedDate <= '2019/03/29 15:00' AND Id IN ('1234', '2345')

Additionally Id, Type, Title, CreatedDate, CreatedByUserName, AND LastUpdatedDatetime columns can be used in the ORDER BY clause, as following:

SELECT * FROM Attachments ORDER BY Id DESC

SELECT * FROM Attachments ORDER BY CreatedByUserName ASC

CQL

Note: Filtering with CQL has the highest priority and all the other filters except "Excerpt" will be ignored when CQL filter is present in the query.

SELECT * FROM Attachments WHERE CQL = 'creator = currentUser() AND content = "1234" OR space.type = "global"'

Columns

Name	Type	References	SupportedOperators	Description
Id [KEY]	String		=,!=,IN,NOT IN	Id of the attachment.
Type	String		=,!=,IN,NOT IN	Type of the content.
Title	String		=,!=,LIKE,IN,NOT IN	Title of the attachment.
Status	String			Status of the attachment.
SpaceKey	String	Spaces.Key	=,!=,IN,NOT IN	The key of the space that the attachment belongs to.
SpaceType	String	Spaces.Type	=,!=,IN,NOT IN	The type of the space that the attachment belongs to.
Position	String			Position of the attachment.
URL	String			URL of the attachment.
Excerpt	String			Excerpt of the attachment.
IsLatest	Boolean			Indicator if this is the latest version of the attachment.
CreatedByUserName	String		=,!=,IN,NOT IN	Username of the user who created the attachment.
CreatedByUserType	String			Type of the user who created the attachment.
CreatedDate	Datetime		=,>,>=,<,<=	Datetime for the creation of the attachment.
LastUpdatedDatetime	Datetime		=,>,>=,<,<=	Datetime of the last updated version of the attachment.
LastUpdatedMessage	String			Message of the last updated version.
LastUpdatedNumber	Integer			Number of the last updated version.
LastUpdatedUserName	String			Username of the user who updated the latest version.
LastUpdatedUserType	String			Type of the user who updated the latest version.
LastUpdatedIsMinorEdit	Boolean			Indicator if this version is a minor edit.
LastUpdatedIsHidden	Boolean			Indicator if the last updated version is hidden or not.
PreviousVersionUserName	String			Username of the user who updated the previous version.
PreviousVersionUserType	String			Type of the user who updated the previous version.
PreviousVersionDatetime	Datetime			Datetime when the previous version was edited.
PreviousVersionMessage	String			Message for the previously edited version.
PreviousVersionNumber	String			Number of the previously edited version.
PreviousVersionIsMinorEdit	Boolean			Indicator if the previous version was a minor edit.
PreviousVersionIsHidden	Boolean			Indicator if the previous version was hidden or not.
LinksEditui	String			The LinksEditui of the page content.
LinksSelf	String			The LinksSelf of the content.
LinksTinyui	String			The LinksTinyui of the content.
LinksWebui	String			The LinksWebui of the content.
ItemURL	String			The URL reference of the element in UI.
ContainerId	String			The Id of the container of the content.
MediaType	String			Media Type of the attachment.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name	Type	Description
CQL	String		CQL (Confluence Query Language) allows you to build structured queries.

Fetch a paginated list of AuditRecord instances dating back to a certain time.

Table Specific Information

Select

The Cloud will use the Confluence 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.

• SearchString supports the '=' comparisons.
• StartDate supports the '=' comparisons.
• EndDate supports the '=' comparisons.

For example, the following queries are processed server side:

SELECT * FROM AuditRecords WHERE SearchString = 'your search string'

SELECT * FROM AuditRecords WHERE StartDate = '2019-08-12'

SELECT * FROM AuditRecords WHERE EndDate = '2019-08-15'

Columns

Name	Type	References	SupportedOperators	Description
AffectedObjectName	String			Name of the object that was affected by changes.
AffectedObjectType	String			Type of the object that was affected by changes.
AuthorDisplayName	String			Display name of the person who made the changes.
AuthorType	String			Type of the author who made the changes.
UserKey	String			Unique identifier of the author.
UserName	String			User name of the author.
Category	String			Category of the object.
CreationDate	Datetime			Date when the object was created.
Description	String			Description of the object.
RemoteAddress	String			Remote address of the object.
Summary	String			Summary of the object.
IsSysAdmin	Boolean			Identifier whether object is system administered or not.
SearchString	String		=	Text that is inserted by the user to search for a specific object.
StartDate	Datetime		=	Start date of the audit.
EndDate	Datetime		=	End date of the audit.

Get information about a specific blogpost.

Table Specific Information

Select

The Cloud will use the Confluence 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. You can also search for Attachments using CQL (Confluence Query Language).

• Id supports the '=,!=,IN,NOT IN' comparisons.
• Type supports the '=,!=,IN,NOT IN' comparisons.
• Title supports the '=,!=,LIKE,NOT LIKE,IN,NOT IN' comparisons.
• SpaceKey supports the '=,!=,IN,NOT IN' comparisons.
• SpaceType supports the '=,!=,IN,NOT IN' comparisons.
• CreatedByUserName supports the '=,!=,IN,NOT IN' comparisons.
• CreatedDate supports the '=,!=,>,>=,<,<=' comparisons.
• LastUpdatedDatetime supports the '=,!=,>,>=,<,<=' comparisons.

For example, the following queries are processed server side:

SQL

SELECT * FROM Blogposts WHERE Id = '1234'

SELECT * FROM Blogposts WHERE Id IN ('1234', '2345')

SELECT * FROM Blogposts WHERE Id = '123458' AND Type = 'blogpost'

SELECT * FROM Blogposts WHERE CreatedDate <= '2019/03/29 15:00' AND Id IN ('1234', '2345')

Additionally Id, Type, Title, CreatedDate, CreatedByUserName, AND LastUpdatedDatetime columns can be used in the ORDER BY clause, as following:

SELECT * FROM Blogposts ORDER BY Id DESC

SELECT * FROM Blogposts ORDER BY CreatedByUserName ASC

CQL

Note: Filtering with CQL has the highest priority and all the other filters except "Excerpt" will be ignored when CQL filter is present in the query.

SELECT * FROM Blogposts WHERE CQL = 'creator = currentUser() AND content = "1234" OR space.type = "global"'

Columns

Name	Type	References	SupportedOperators	Description
Id [KEY]	String		=,!=,IN,NOT IN	Id of the blogpost.
Type	String		=,!=,IN,NOT IN	Type of the content.
Title	String		=,!=,LIKE,IN,NOT IN	Title of the blogpost.
Status	String			Status of the blogpost.
SpaceKey	String	Spaces.Key	=,!=,IN,NOT IN	The key of the space that the blogpost belongs to.
SpaceType	String	Spaces.Type	=,!=,IN,NOT IN	The type of the space that the blogpost belongs to.
Position	String			Position of the blogpost.
URL	String			URL of the blogpost.
Excerpt	String			Excerpt of the blogpost.
IsLatest	Boolean			Indicator if this is the latest version of the blogpost.
CreatedByUserName	String		=,!=,IN,NOT IN	Username of the user who created the blogpost.
CreatedByUserType	String			Type of the user who created the blogpost.
CreatedDate	Datetime		=,>,>=,<,<=	Datetime for the creation of the blogpost.
LastUpdatedDatetime	Datetime		=,>,>=,<,<=	Datetime of the last updated version of the blogpost.
LastUpdatedMessage	String			Message of the last updated version.
LastUpdatedNumber	Integer			Number of the last updated version.
LastUpdatedUserName	String			Username of the user who updated the latest version.
LastUpdatedUserType	String			Type of the user who updated the latest version.
LastUpdatedIsMinorEdit	Boolean			Indicator if this version is a minor edit.
LastUpdatedIsHidden	Boolean			Indicator if the last updated version is hidden or not.
PreviousVersionUserName	String			Username of the user who updated the previous version.
PreviousVersionUserType	String			Type of the user who updated the previous version.
PreviousVersionDatetime	Datetime			Datetime when the previous version was edited.
PreviousVersionMessage	String			Message for the previously edited version.
PreviousVersionNumber	String			Number of the previously edited version.
PreviousVersionIsMinorEdit	Boolean			Indicator if the previous version was a minor edit.
PreviousVersionIsHidden	Boolean			Indicator if the previous version was hidden or not.
LinksEditui	String			The LinksEditui of the page content.
LinksSelf	String			The LinksSelf of the content.
LinksTinyui	String			The LinksTinyui of the content.
LinksWebui	String			The LinksWebui of the content.
ItemURL	String			The URL reference of the element in UI.
ContainerId	String			The Id of the container of the content.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name	Type	Description
CQL	String		CQL (Confluence Query Language) allows you to build structured queries.

Get information about a specific comment.

Table Specific Information

Select

The Cloud will use the Confluence 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. You can also search for Attachments using CQL (Confluence Query Language).

• Id supports the '=,!=,IN,NOT IN' comparisons.
• Type supports the '=,!=,IN,NOT IN' comparisons.
• Title supports the '=,!=,LIKE,NOT LIKE,IN,NOT IN' comparisons.
• SpaceKey supports the '=,!=,IN,NOT IN' comparisons.
• SpaceType supports the '=,!=,IN,NOT IN' comparisons.
• CreatedByUserName supports the '=,!=,IN,NOT IN' comparisons.
• CreatedDate supports the '=,!=,>,>=,<,<=' comparisons.
• LastUpdatedDatetime supports the '=,!=,>,>=,<,<=' comparisons.

For example, the following queries are processed server side:

SQL

SELECT * FROM Comments WHERE Id = '1234'

SELECT * FROM Comments WHERE Id IN ('1234', '2345')

SELECT * FROM Comments WHERE Id = '294922' OR Type = 'comment'

SELECT * FROM Comments WHERE CreatedDate <= '2019/03/29 15:00' AND Id IN ('1234', '2345')

Additionally Id, Type, Title, CreatedDate, CreatedByUserName, AND LastUpdatedDatetime columns can be used in the ORDER BY clause, as following:

SELECT * FROM Comments ORDER BY Id DESC

SELECT * FROM Comments ORDER BY CreatedByUserName ASC

CQL

Note: Filtering with CQL has the highest priority and all the other filters except "Excerpt" will be ignored when CQL filter is present in the query.

SELECT * FROM Comments WHERE CQL = 'creator = currentUser() AND content = "1234" OR space.type = "global"'

Columns

Name	Type	References	SupportedOperators	Description
Id [KEY]	String		=,!=,IN,NOT IN	Id of the comment.
Type	String		=,!=,IN,NOT IN	Type of the content.
Title	String			Title of the comment.
Status	String			Status of the comment.
SpaceKey	String	Spaces.Key	=,!=,IN,NOT IN	The key of the space that the comment belongs to.
SpaceType	String	Spaces.Type	=,!=,IN,NOT IN	The type of the space that the comment belongs to.
Position	String			Position of the comment.
URL	String			URL of the comment.
Excerpt	String			Excerpt of the comment.
IsLatest	Boolean			Indicator if this is the latest version of the comment.
CreatedByUserName	String		=,!=,IN,NOT IN	Username of the user who created the comment.
CreatedByUserType	String			Type of the user who created the comment.
CreatedDate	Datetime		=,>,>=,<,<=	Datetime for the creation of the comment.
LastUpdatedDatetime	Datetime		=,>,>=,<,<=	Datetime of the last updated version of the comment.
LastUpdatedMessage	String			Message of the last updated version.
LastUpdatedNumber	Integer			Number of the last updated version.
LastUpdatedUserName	String			Username of the user who updated the latest version.
LastUpdatedUserType	String			Type of the user who updated the latest version.
LastUpdatedIsMinorEdit	Boolean			Indicator if this version is a minor edit.
LastUpdatedIsHidden	Boolean			Indicator if the last updated version is hidden or not.
PreviousVersionUserName	String			Username of the user who updated the previous version.
PreviousVersionUserType	String			Type of the user who updated the previous version.
PreviousVersionDatetime	Datetime			Datetime when the previous version was edited.
PreviousVersionMessage	String			Message for the previously edited version.
PreviousVersionNumber	String			Number of the previously edited version.
PreviousVersionIsMinorEdit	Boolean			Indicator if the previous version was a minor edit.
PreviousVersionIsHidden	Boolean			Indicator if the previous version was hidden or not.
LinksEditui	String			The LinksEditui of the page content.
LinksSelf	String			The LinksSelf of the content.
LinksTinyui	String			The LinksTinyui of the content.
LinksWebui	String			The LinksWebui of the content.
ItemURL	String			The URL reference of the element in UI.
ContainerId	String			The Id of the container of the content.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name	Type	Description
CQL	String		CQL (Confluence Query Language) allows you to build structured queries.

Get information about the users who have contributed to the content.

Table Specific Information

Select

The Cloud will use the Confluence 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.

Note: ContentId is required in order to query the Contributors view.

• ContentId supports the '=,!=,IN,NOT IN' comparisons.
• AccountId supports the '=,!=,IN,NOT IN' comparisons.

For example, the following queries are processed server side:

SELECT * FROM Contributors WHERE ContentId = '1234'

SELECT * FROM Contributors WHERE ContentId! = '1234'

SELECT * FROM Contributors WHERE ContentId IN ('1234', '2345')

SELECT * FROM Contributors WHERE ContentId NOT IN ('1234', '2345')

SELECT * FROM Contributors WHERE AccountId = '12345678'

SELECT * FROM Contributors WHERE AccountId! = '12345678'

SELECT * FROM Contributors WHERE AccountId IN ('12345678', '23456789')

SELECT * FROM Contributors WHERE AccountId NOT IN ('12345678', '23456789')

Additionally, ContentId column can be used in the ORDER BY clause, as following:

SELECT * FROM Contributors ORDER BY ContentId DESC

Columns

Name	Type	References	SupportedOperators	Description
ContentId [KEY]	String		=,!=,IN,NOT IN	This is the Id of the content that support labels. This can be referenced from Attachments.Id, Pages.Id, Comments.Id or Blogposts.Id.
UserType	String			Type of the contributor.
AccountId	String		=,!=,IN,NOT IN	Unique account Id of the contributor. NOTE: This column is exclusive to Confluence Cloud.
UserName	String		=,!=,IN,NOT IN	Unique user key of the contributor. NOTE: This column is exclusive to Confluence Server.

Get users of a specific group.

Table Specific Information

Select

The Cloud will use the Confluence 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.

• Name supports the '=' comparisons.

For example, the following queries are processed server side:

SELECT * FROM GroupMembers WHERE Name = 'test1'

Columns

Name	Type	References	SupportedOperators	Description
AccountId	String			Account Id of the user.
AccountType	String			Account Type of the user.
DisplayName	String			Display name of the user.
Email	String			Email address of the user.
PublicName	String			Public name or nickname of the user.
ProfilePicturePath	String			Path of the profile picture of the user.
ProfilePictureWidth	Int			Width of the profile picture of the user.
ProfilePictureHeight	Int			Height of the profile picture of the user.
ProfilePictureIsDefault	Boolean			If isDefault of the profile picture of the user.
Operations	String			An operation and the target entity that it applies to
Type	String			Type of the user.
GroupId	String		=	The Id of the group.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name	Type	Description
Name	String		Name of the Group to which these members belong to

Get information about a specific group.

Table Specific Information

Select

The Cloud will use the Confluence 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.

• Name supports the '=,IN' comparisons.
• Id supports the '=' comparisons.

For example, the following queries are processed server side:

SELECT * FROM Groups WHERE Name = 'test'

SELECT * FROM Groups WHERE Name IN ('test1', 'test2')

SELECT * FROM Groups WHERE Id = 'ef75d879-6b69-4260-942a-ff5231e08be0'

Columns

Name	Type	References	SupportedOperators	Description
Id [KEY]	String		=	Id of the group.
Name [KEY]	String			Name of the group.
Type	String			Type of the group.

Retrieve information related to the groups restrictions applied to a certain content. The maximum number of restrictions per operation is limited to 200. ContentId is required.

Columns

Name	Type	References	SupportedOperators	Description
Operation	String			Specifies the type of operation (read, update) that the restriction applies to.
Name	String			Stores the name of the group that the restriction applies to.
Type	String			Specifies the type of the group.
ContentId	String		=	The ID of the content where the restriction is applied.

Get information about the labels that a specific content has.

Table Specific Information

Select

The Cloud will use the Confluence 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.

Note: ContentId is required in order to query the Labels view.

• ContentId supports the '=,!=,IN,NOT IN' comparisons.
• LabelName supports the '=,!=,IN,NOT IN' comparisons.

For example, the following queries are processed server side:

SELECT * FROM Labels WHERE ContentId = '1234'

SELECT * FROM Labels WHERE ContentId! = '1234'

SELECT * FROM Labels WHERE ContentId IN ('1234', '2345')

SELECT * FROM Labels WHERE ContentId NOT IN ('1234', '2345')

SELECT * FROM Labels WHERE LabelName = 'test'

SELECT * FROM Labels WHERE LabelName != 'test'

SELECT * FROM Labels WHERE LabelName IN ('test1', 'test2')

SELECT * FROM Labels WHERE LabelName NOT IN ('test1', 'test2')

Additionally, ContentId column can be used in the ORDER BY clause, as following:

SELECT * FROM Labels ORDER BY ContentId DESC

Columns

Name	Type	References	SupportedOperators	Description
ContentId [KEY]	String		=,!=,IN,NOT IN	This is the Id of the content that support labels. This can be referenced from Attachments.Id, Pages.Id, or Blogposts.Id.
LabelId	String			Id of the label.
LabelName	String		=,!=,IN,NOT IN	Name of the label.
LabelPrefix	String			Prefix of the label.

To look at a page hierarchy including who is the parent page.

Table Specific Information

Select

The Cloud will use the Confluence API to process WHERE clause conditions built with the following column and operator.

Note: PageId is required in order to query the PageAncestors view.

• PageId supports the '=' comparison.

For example, the following queries are processed server side:

SELECT * FROM PageAncestors WHERE PageId = '33106'
SELECT * FROM PageAncestors WHERE PageId IN ('163902', '33106')

Columns

Name	Type	References	SupportedOperators	Description
Id [KEY]	String			The Id of the PageAncestors.
ExpandableAncestors	String			The ExpandableAncestors of the PageAncestors.
ExpandableBody	String			The ExpandableBody of the PageAncestors.
ExpandableChildren	String			The ExpandableChildren of the PageAncestors.
ExpandableChildTypes	String			The ExpandableChildTypes of the PageAncestors.
ExpandableContainer	String			The ExpandableContainer of the PageAncestors.
ExpandableDescendants	String			The ExpandableDescendants of the PageAncestors.
ExpandableHistory	String			The ExpandableHistory of the PageAncestors.
ExpandableMetadata	String			The ExpandableMetadata of the PageAncestors.
ExpandableOperations	String			The ExpandableOperations of the PageAncestors.
ExpandableRestrictions	String			The ExpandableRestrictions of the PageAncestors.
ExpandableSchedulePublishDate	Datetime			The ExpandableSchedulePublishDate of the PageAncestors.
ExpandableSpace	String			The ExpandableSpace of the PageAncestors.
ExpandableVersion	String			The ExpandableVersion of the PageAncestors.
LinksEditui	String			The LinksEditui of the PageAncestors.
LinksSelf	String			The LinksSelf of the PageAncestors.
LinksTinyui	String			The LinksTinyui of the PageAncestors.
LinksWebui	String			The LinksWebui of the PageAncestors.
ExtensionsPosition	String			The ExtensionsPosition of the PageAncestors.
Status	String			The Status of the PageAncestors.
Title	String			The Title of the PageAncestors.
Type	String			The Type of the PageAncestors.
PageId	String	Pages.Id	=,!=,IN,NOT IN	The Id of the page.

To look at a page hierarchy including who is the child page.

Table Specific Information

Select

The Cloud will use the Confluence API to process WHERE clause conditions built with the following column and operator.

Note: PageId is required in order to query the PageChildrens view.

• PageId supports the '=' comparison.

For example, the following queries are processed server side:

SELECT * FROM PageChildrens WHERE PageId = '33106'
SELECT * FROM PageChildrens WHERE PageId IN ('163902', '33106')

Columns

Name	Type	References	SupportedOperators	Description
Id [KEY]	String			The Id of the PageChildrens.
ExpandableAncestors	String			The ExpandableAncestors of the PageChildrens.
ExpandableBody	String			The ExpandableBody of the PageChildrens.
ExpandableChildren	String			The ExpandableChildren of the PageChildrens.
ExpandableChildTypes	String			The ExpandableChildTypes of the PageChildrens.
ExpandableContainer	String			The ExpandableContainer of the PageChildrens.
ExpandableDescendants	String			The ExpandableDescendants of the PageChildrens.
ExpandableHistory	String			The ExpandableHistory of the PageChildrens.
ExpandableMetadata	String			The ExpandableMetadata of the PageChildrens.
ExpandableOperations	String			The ExpandableOperations of the PageChildrens.
ExpandableRestrictions	String			The ExpandableRestrictions of the PageChildrens.
ExpandableSchedulePublishDate	Datetime			The ExpandableSchedulePublishDate of the PageChildrens.
ExpandableSpace	String			The ExpandableSpace of the PageChildrens.
ExpandableVersion	String			The ExpandableVersion of the PageChildrens.
LinksEditui	String			The LinksEditui of the PageChildrens.
LinksSelf	String			The LinksSelf of the PageChildrens.
LinksTinyui	String			The LinksTinyui of the PageChildrens.
LinksWebui	String			The LinksWebui of the PageChildrens.
ExtensionsPosition	String			The ExtensionsPosition of the PageChildrens.
Status	String			The Status of the PageChildrens.
Title	String			The Title of the PageChildrens.
Type	String			The Type of the PageChildrens.
PageId	String	Pages.Id	=,!=,IN,NOT IN	The Id of the page.

Get comments specific to a page.

Table Specific Information

Select

The Cloud will use the Confluence API to process WHERE clause conditions built with the following column and operator.

Note: PageId is required in order to query the PageComments view.

• PageId supports the '=' comparison.

For example, the following queries are processed server side:

SELECT * FROM PageComments WHERE PageId = '163902' 
SELECT * FROM PageComments WHERE PageId IN ('163902', '33106')

Columns

Name	Type	References	SupportedOperators	Description
Id [KEY]	String			The Id of the comments mentioned in the Page.
ExpandableAncestors	String			The ExpandableAncestors of the page comments.
ExpandableChildren	String			The ExpandableChildren of the page comments.
ExpandableContainer	String			The ExpandableContainer of the page comments.
ExpandableDescendants	String			The ExpandableDescendants of the page comments.
ExpandableHistory	String			The ExpandableHistory of the page comments.
ExpandableMetadata	String			The ExpandableMetadata of the page comments.
ExpandableOperations	String			The ExpandableOperations of the page comments.
ExpandableRestrictions	String			The ExpandableRestrictions of the page comments.
ExpandableSpace	String			The ExpandableSpace of the page comments.
ExpandableVersion	String			The ExpandableVersion of the page comments.
LinksSelf	String			The LinksSelf of the page comments.
LinksWebui	String			The LinksWebui of the page comments.
BodyExpandableAnonymousExportView	String			The BodyExpandableAnonymousExportView of the page comments.
BodyExpandableEditor	String			The BodyExpandableEditor of the page comments.
BodyExpandableExportView	String			The BodyExpandableExportView of the page comments.
BodyExpandableStorage	String			The BodyExpandableStorage of the page comments.
BodyExpandableStyledView	String			The BodyExpandableStyledView of the page comments.
BodyViewExpandableContent	String			The BodyViewExpandableContent of the page comments.
BodyViewExpandableWebresource	String			The BodyViewExpandableWebresource of the page comments.
BodyViewRepresentation	String			The BodyViewRepresentation of the page comments.
BodyViewValue	String			The BodyViewValue of the page comments.
ExtensionsExpandableResolution	String			The ExtensionsExpandableResolution of the page comments.
ExtensionsLocation	String			The ExtensionsLocation of the page comments.
Status	String			The Status of the page comments.
Title	String			The Title of the page comments.
Type	String			The Type of the page comments.
PageId	String	Pages.Id	=,!=,IN,NOT IN	The Id of the page.

Get content from the page.

Table Specific Information

Select

The Cloud will use the Confluence API to process WHERE clause conditions built with the following column and operator.

Note: PageId is required in order to query the PageContents view.

• PageId supports the '=' comparison.

For example, the following queries are processed server side:

SELECT * FROM PageContents WHERE PageId = '163902'
SELECT * FROM PageContents WHERE PageId IN ('163902', '33106')

Columns

Name	Type	References	SupportedOperators	Description
Id [KEY]	String			The Id of the page content.
ExpandableAncestors	String			The ExpandableAncestors of the page content.
ExpandableChildren	String			The ExpandableChildren of the page content.
ExpandableChildTypes	String			The ExpandableChildTypes of the page content.
ExpandableContainer	String			The ExpandableContainer of the page content.
ExpandableDescendants	String			The ExpandableDescendants of the page content.
ExpandableHistory	String			The ExpandableHistory of the page content.
ExpandableMetadata	String			The ExpandableMetadata of the page content.
ExpandableOperations	String			The ExpandableOperations of the page content.
ExpandableRestrictions	String			The ExpandableRestrictions of the page content.
ExpandableSchedulePublishDate	Datetime			The ExpandableSchedulePublishDate of the page content.
ExpandableSpace	String			The ExpandableSpace of the page content.
ExpandableVersion	String			The ExpandableVersion of the page content.
LinksBase	String			The LinksBase of the page content.
LinksCollection	String			The LinksCollection of the page content.
LinksContext	String			The LinksContext of the page content.
LinksEditui	String			The LinksEditui of the page content.
LinksSelf	String			The LinksSelf of the page content.
LinksTinyui	String			The LinksTinyui of the page content.
LinksWebui	String			The LinksWebui of the page content.
BodyExpandableAnonymousExportView	String			The BodyExpandableAnonymousExportView of the page content.
BodyExpandableAtlasDocFormat	String			The BodyExpandableAtlasDocFormat of the page content.
BodyExpandableDynamic	String			The BodyExpandableDynamic of the page content.
BodyExpandableEditor	String			The BodyExpandableEditor of the page content.
BodyExpandableEditor2	String			The BodyExpandableEditor2 of the page content.
BodyExpandableExportView	String			The BodyExpandableExportView of the page content.
BodyExpandableStyledView	String			The BodyExpandableStyledView of the page content.
BodyExpandableView	String			The BodyExpandableView of the page content.
BodyStorageExpandableContent	String			The BodyStorageExpandableContent of the page content.
BodyStorageEmbeddedContent	String			The BodyStorageEmbeddedContent of the page content.
BodyStorageRepresentation	String			The BodyStorageRepresentation of the page content.
BodyStorageValue	String			The BodyStorageValue of the page content.
ExtensionsPosition	String			The ExtensionsPosition of the page content.
Status	String			The Status of the page content.
Title	String			The Title of the page content.
Type	String			The Type of the page content.
PageId	String	Pages.Id	=,!=,IN,NOT IN	The Id of the page.

Returns space permissions for the specified space(s).

Columns

Name	Type	References	SupportedOperators	Description
Id [KEY]	String			The ID of the space permission.
OperationKey	String			The type of operation that the space permission corresponds to.
OperationTargetType	String			The type of entity the operation type targets.
PrincipalId	String			The ID of the entity the space permissions corresponds to.
PrincipalType	String			The type of the entity the space permissions corresponds to.
SpaceId	String	Spaces.Id	=	The ID of the space that the permission is associated with.

Returns information about a number of spaces.

Table Specific Information

Select

The Cloud will use the Confluence 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. You can also search for Attachments using CQL (Confluence Query Language).

• Key supports the '=,!=,IN,NOT IN' comparisons.
• Name supports the '=,LIKE,NOT LIKE' comparisons.
• Type supports the '=,!=,IN,NOT IN' comparisons.
• Excerpt supports the '=' comparisons.

For example, the following queries are processed server side:

SQL

SELECT * FROM Spaces WHERE Key = 'abc'

SELECT * FROM Spaces WHERE Name IN ('name1', 'name2')

SELECT * FROM Spaces WHERE Excerpt = 'driver development'

SELECT * FROM Spaces WHERE Key = 'abc' AND Type = 'global'

CQL

Note: Filtering with CQL has the highest priority and all the other filters except "Excerpt" will be ignored when CQL filter is present in the query.

SELECT * FROM Spaces WHERE CQL = 'type = space AND space.title~"Driver Development"' AND Excerpt = 'indexed'

Columns

Name	Type	References	SupportedOperators	Description
Id	String			Id of the space.
Key [KEY]	String		=,!=,IN,NOT IN	Unique key of the space.
Name	String		=,!=	Name of the space.
IconPath	String			Path of the space icon.
IconWidth	Integer			Width of the space icon.
IconHeight	Integer			Height of the space icon.
IsIconDefault	Boolean			Indicator if the icon is default.
Excerpt	String			Excerpt of the space.
Type	String		=,!=,IN,NOT IN	Type of the space.
Url	String			Url of the space.
LastModified	Datetime			Last modified datetime.
ItemURL	String			The URL reference of the element in UI.
Description	String			Description of the space.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name	Type	Description
CQL	String		CQL (Confluence Query Language) allows you to build structured queries.

Get information regarding tasks.

Columns

Name	Type	References	SupportedOperators	Description
Id [KEY]	String		=	The ID of the task.
AssignedTo	String		=	Account ID of the user to whom this task is assigned.
AtlasDoc	String			The atlas doc format.
BlogPostId	String		=	The blog post ID of the task.
CompletedAt	Datetime			Time when task is completed.
CompletedBy	String		=	Account ID of the user who completed this task.
CreatedAt	Datetime			Time when task is created.
CreatedBy	String		=	Account ID of the user who created this task.
DueAt	Datetime			Time when task is due.
LocalId	String			The local ID.
PageId	String		=	The page ID of the task.
SpaceId	String		=	The space ID of the task.
Status	String		=	The status of the task.
Storage	String			The body storage of the task.
UpdatedAt	Datetime			Time when task is updated.

Get information about a user identified.

Table Specific Information

Select

The Cloud will use the Confluence 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. You can also search for Attachments using CQL (Confluence Query Language).

• AccountId supports the '=,!=,IN,NOT IN' comparisons.
• PublicName supports the '=,LIKE,NOT LIKE' comparisons.

For example, the following queries are processed server side:

SQL

SELECT * FROM Users WHERE AccountId = '1234'

SELECT * FROM Users WHERE AccountId IN ('1234', '2345')

SELECT * FROM Users WHERE PublicName = 'confluenceuser'

CQL

Note: Filtering with CQL has the highest priority and all the other filters except "Excerpt" will be ignored when CQL filter is present in the query.

SELECT * FROM Users WHERE CQL = 'user.userKey = "4028d6096b696826016b696960860000" AND type = user' AND UserName = 'currentUser()'

Columns

Name	Type	References	SupportedOperators	Description
AccountId [KEY]	String		=,!=,IN,NOT IN	Unique account id for the specific user. NOTE: This column is exclusive to Confluence Cloud.
AccountType	String			Type of the account for the specific user. NOTE: This column is exclusive to Confluence Cloud.
PublicName	String		=,LIKE	Full name of the specific user. NOTE: This column is exclusive to Confluence Cloud.
Email	String			Email of the specific user. NOTE: This column is exclusive to Confluence Cloud.
UserKey [KEY]	String		=,!=,IN,NOT IN	Unique key for the specific user. NOTE: This column is exclusive to Confluence Server.
UserName	String		=	User name of the specific user. NOTE: This column is exclusive to Confluence Server.
Status	String			Status of the specific user. NOTE: This column is exclusive to Confluence Server.
Type	String			Type of the specific user.
Excerpt	String			Excerpt of the user.
ProfilePicturePath	String			Path of the profile picture file.
ProfilePictureWidth	Integer			Profile picture width.
ProfilePictureHeight	Integer			Profile picture height.
IsDefaultPicture	Boolean			Indicator showing if the profile picture is never changed.
DisplayName	String			Display name of the specific user.
Url	String			Url of the user profile.
LastModified	Datetime			Last modified timestamp of the user information.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name	Type	Description
CQL	String		CQL (Confluence Query Language) allows you to build structured queries.

Retrieve information related to the users restrictions applied to a certain content. The maximum number of restrictions per operation is limited to 200. ContentId is required.

Columns

Name	Type	References	SupportedOperators	Description
Operation	String			Specifies the type of operation (read, update) that the restriction applies to.
UserKey	String			Specifies the UserKey, the unique identifier key for the user.
DisplayName	String			The display name of the user associated with the restriction.
Username	String			Specifies the Username of the user.
Type	String			Specifies the type of the user (for example, 'known').
ContentId	String		=	The ID of the content where the restriction is applied.

Get the total number of distinct viewers a piece of content has.

Table Specific Information

Select

The Cloud will use the Confluence API to process WHERE clause conditions built with the following column and operator.

• FromDate supports the '=' comparison.
• ContentId supports the '=,IN' comparisons.

For example, the following queries are processed server side:

SELECT * FROM ViewersAnalytics WHERE FromDate = '2023-01-02'

Columns

Name	Type	References	SupportedOperators	Description
ContentId	String		=	The Id of the page content.
NumberOfDistinctViewers	String			the total number of distinct viewers a piece of content has.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name	Type	Description
FromDate	Date		The number of views for the content from the date.

Get the total number of views a piece of content has.

Table Specific Information

Select

The Cloud will use the Confluence API to process WHERE clause conditions built with the following column and operator.

• FromDate supports the '=' comparison.
• ContentId supports the '=,IN' comparisons.

For example, the following queries are processed server side:

SELECT * FROM ViewsAnalytics WHERE FromDate = '2023-01-02'

Columns

Name	Type	References	SupportedOperators	Description
ContentId	String		=	The Id of the page content.
NumberOfViews	String			the total number of views a piece of content has.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name	Type	Description
FromDate	Date		The number of views for the content from the date.

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

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

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

Name	Description

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

スキーマテーブル

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

• 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	テーブルが更新可能かどうか。

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

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

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

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 から返されたフィールドがテーブルの主キーであるかどうか。

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

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

          SELECT * FROM sys_procedures
          

Columns

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

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

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

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

Columns

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

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

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

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

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

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	The type of authentication to use when connecting to Confluence.
URL	The URL to your JIRA endpoint.
User	認証するConfluence ユーザーアカウントのユーザーID を指定します。
Password	認証するユーザーアカウントのパスワードを指定します。
APIToken	APIToken of the currently authenticated user.
PAT	Personal Access Token of the currently authenticated user.
Timezone	Specify the timezone of the Confluence instance in order to use the datetime filters accordingly and retrieve the results according to your timezone. An example of a timezone would be America/New_York.

SSO

---

プロパティ	説明
SSOLoginURL	ID プロバイダーのログインURL。
SSOProperties	ID プロバイダーへの接続に必要な追加プロパティを、セミコロンで区切ったリスト形式で指定します。
SSOExchangeUrl	SAML 応答を処理してサービスの資格情報と交換するために使用するURL。
SSOAppName	アプリ名を必要とするSSO のIdP で使用されるアプリ名.
SSOAppPassword	アプリパスワードを必要とするSSO のIdP で使用されるアプリパスワード。

OAuth

---

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

SSL

---

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

Logging

---

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

Schema

---

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

Miscellaneous

---

プロパティ	説明
IncludeArchivedSpaces	Whether to include content from archived spaces in the result. This defaults to false.
MaxRows	集計やGROUP BY を使用しないクエリで返される最大行数を指定します。
Pagesize	Confluence から返される、1ページあたりの結果の最大数を指定します。この設定は、ほとんどのユースケースに最適化されている、データソースによって設定されたデフォルトのページサイズをオーバーライドします。
PseudoColumns	テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。
SpaceKey	By specifying the SpaceKey, the search results will only display contents from this specific space.
Timeout	provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。

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

---

プロパティ	説明
AuthScheme	The type of authentication to use when connecting to Confluence.
URL	The URL to your JIRA endpoint.
User	認証するConfluence ユーザーアカウントのユーザーID を指定します。
Password	認証するユーザーアカウントのパスワードを指定します。
APIToken	APIToken of the currently authenticated user.
PAT	Personal Access Token of the currently authenticated user.
Timezone	Specify the timezone of the Confluence instance in order to use the datetime filters accordingly and retrieve the results according to your timezone. An example of a timezone would be America/New_York.

The type of authentication to use when connecting to Confluence.

Possible Values

OAuth, Basic, APIToken, Crowd, OKTA, PAT

データ型

string

デフォルト値

"Basic"

解説

• OAuth: Set this to perform OAuth authentication.
• Basic: Set this to use basic User/Password authentication for Server instances.
• APIToken: Set this to use basic User/APIToken authentication for Cloud instances.
• Crowd: Set this to perform Crowd SSO authentication.
• OKTA: Set this to perform OKTA SSO authentication.
• PAT: Set this to use a Personal Access Token (PAT) for Server instances of Confluence 7.9 and later.

The URL to your JIRA endpoint.

データ型

string

デフォルト値

""

解説

The URL to your JIRA endpoint; for example, https://yoursitename.atlassian.net.

認証するConfluence ユーザーアカウントのユーザーID を指定します。

データ型

string

デフォルト値

""

解説

認証サーバーは、ユーザーのID を検証するためにUser とPassword の両方を必要とします。

認証するユーザーアカウントのパスワードを指定します。

データ型

string

デフォルト値

""

解説

認証サーバーは、ユーザーのID を検証するためにUser とPassword の両方を必要とします。

APIToken of the currently authenticated user.

データ型

string

デフォルト値

""

解説

APIToken of the currently authenticated user.

Personal Access Token of the currently authenticated user.

データ型

string

デフォルト値

""

解説

Personal Access Token of the currently authenticated user.

Specify the timezone of the Confluence instance in order to use the datetime filters accordingly and retrieve the results according to your timezone. An example of a timezone would be America/New_York.

データ型

string

デフォルト値

""

解説

Note: You can find the timezone in your Confluence Server by navigating to Settings -> General Configuration and then by clicking System Information on the left panel. On your Confluence Cloud, the timezone should be set. In order to set it, navigate to the User Profile icon on the bottom left corner and click Settings. In that section, you will be able to set the Timezone by clicking the Edit button.

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

---

プロパティ	説明
SSOLoginURL	ID プロバイダーのログインURL。
SSOProperties	ID プロバイダーへの接続に必要な追加プロパティを、セミコロンで区切ったリスト形式で指定します。
SSOExchangeUrl	SAML 応答を処理してサービスの資格情報と交換するために使用するURL。
SSOAppName	アプリ名を必要とするSSO のIdP で使用されるアプリ名.
SSOAppPassword	アプリパスワードを必要とするSSO のIdP で使用されるアプリパスワード。

ID プロバイダーのログインURL。

データ型

string

デフォルト値

""

解説

ID プロバイダーのログインURL。

ID プロバイダーへの接続に必要な追加プロパティを、セミコロンで区切ったリスト形式で指定します。

データ型

string

デフォルト値

""

解説

ID プロバイダーへの接続に必要な追加プロパティを、セミコロンで区切ったリスト形式で指定します。SSOLoginURL と一緒に使用します。

SSO 設定については、 で詳しく説明します。

SAML 応答を処理してサービスの資格情報と交換するために使用するURL。

データ型

string

デフォルト値

""

解説

CData Cloud はここで指定されたURL を使用してSAML 応答を処理し、サービスの資格情報と交換します。 取得した資格情報はSSO 接続時の最後の情報であり、Confluence との通信に使用されます。

アプリ名を必要とするSSO のIdP で使用されるアプリ名.

データ型

string

デフォルト値

""

解説

SSOAppPassword とともに、SSO IdP で設定されたアプリを識別して認証するために指定できます。 現在、クラウドのみサポートしています。

アプリパスワードを必要とするSSO のIdP で使用されるアプリパスワード。

データ型

string

デフォルト値

""

解説

SSOAppName とともに、SSO IdP で設定されたアプリを識別して認証するために指定できます。 現在、クラウドのみサポートしています。

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

---

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

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

データ型

string

デフォルト値

""

解説

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

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

データ型

string

デフォルト値

""

解説

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

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

---

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

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

データ型

string

デフォルト値

""

解説

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

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

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

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

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

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

---

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

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

データ型

string

デフォルト値

"1"

解説

このプロパティは、Cloud がログファイルに含める詳細レベルを定義します。 Verbosity レベルを高くするとログに記録される情報の詳細が増えますが、ログファイルが大きくなり取り込まれるデータが増えるためパフォーマンスが低下する可能性があります。

デフォルトのVerbosity レベルは1で、通常の運用にはこれが推奨されます。 より高いVerbosity レベルは主にデバッグを目的としています。 各レベルの詳細については、ログ を参照してください。

LogModules プロパティと組み合わせることで、Verbosity は特定の情報カテゴリに対するログの詳細度を調整できます。

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

---

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

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

データ型

string

デフォルト値

""

解説

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

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

---

プロパティ	説明
IncludeArchivedSpaces	Whether to include content from archived spaces in the result. This defaults to false.
MaxRows	集計やGROUP BY を使用しないクエリで返される最大行数を指定します。
Pagesize	Confluence から返される、1ページあたりの結果の最大数を指定します。この設定は、ほとんどのユースケースに最適化されている、データソースによって設定されたデフォルトのページサイズをオーバーライドします。
PseudoColumns	テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。
SpaceKey	By specifying the SpaceKey, the search results will only display contents from this specific space.
Timeout	provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。

Whether to include content from archived spaces in the result. This defaults to false.

データ型

bool

デフォルト値

false

解説

If this property is set to true, content such as comments, attachments, pages and blogspots belonging to an archived space will be included in the result.

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

データ型

int

デフォルト値

-1

解説

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

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

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

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

データ型

int

デフォルト値

200

解説

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

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

データ型

string

デフォルト値

""

解説

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

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

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

By specifying the SpaceKey, the search results will only display contents from this specific space.

データ型

string

デフォルト値

""

解説

If SpaceKey is specified both in the SQL query as well as a connection property, the value in the SQL query will take precedence over the connection property.

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

データ型

int

デフォルト値

60

解説

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

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

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