LinkedIn への接続を追加

LinkedIn への接続を追加するには：

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

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

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

LinkedIn への接続

LinkedIn CompanyId は各会社固有の一連の数字で、通常6から9桁です。 CompanyId の公開を必要とするLinkedIn エンティティでの作業には、会社ページの管理者権限が必要です。

自社のサイトのLinkedIn Company ID を見つけるには2つの方法があります。

• 自身のLinkedIn ページのCompany ドロップダウンで会社名を検索し、検索結果ページのURL を確認します。 ID は、URL の/search/?f_C=[numeric value]& の後の値です。

• LinkedIn ページ管理者として、All Pages またはHome タブを使用して、ページの管理者ビューに移動します。 ID は、URL のhttps://www.linkedin.com/company/ の後に来る数字です。

CompanyId は、LinkedIn データモデルエンティティのほとんどで要求されます。クエリの一部として直接指定することもできますが、使用しているクエリが簡単に変更できない場合は、グローバルに設定することもできます。

これが実行するクエリに必要かわからない場合は、テーブルやビューの説明を確認するか、カラムまたは擬似カラムとして指定されているかどうかを確認してください。

LinkedIn への認証

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

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

以下のサブセクションでは、利用可能なOAuth フローでのLinkedIn への認証について詳しく説明します。 カスタムOAuth アプリケーションの作成についての情報と、すでに埋め込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、カスタムOAuth アプリケーションの作成 を参照してください。

LinkedIn で利用可能な接続文字列プロパティの全リストは、Connection を参照してください。

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

LinkedIn に必要なスコープおよびエンドポイントドメイン

LinkedIn と連携する場合、アプリケーションはAPI とやりとりするために特定の権限が必要です。

これらの権限はアクセススコープによって定義され、アプリケーションがアクセス可能なデータと実行可能なアクションを決定します。

このトピックでは、LinkedIn プロバイダーに必要なアクセススコープとエンドポイントドメインについての情報を提供します。

スコープについて

スコープは、ユーザーのデータへのアプリケーションによるアクセスを制限するための手段です。これは、アプリケーションがユーザーに代わって実行できる特定のアクションを定義します。

例えば、読み取り専用スコープではアプリケーションにデータの閲覧を許可し、フルアクセススコープではデータの変更を許可することができます。

LinkedIn に必要なスコープ

To see what scopes are granted by each API product, refer to LinkedIn's documentation.

Entity	Statement Types	Minimal Required Scopes
Comments	SELECT	r_organization_social
Comments	INSERT UPDATE DELETE	w_organization_social
CompanyStatusUpdates	SELECT	r_organization_social
CompanyStatusUpdates	INSERT UPDATE DELETE	w_organization_social
Events	SELECT	r_events NOTE: CData's embedded OAuth application does not support this scope. You must create a custom OAuth application and request access for Events Management API from the list of products (see カスタムOAuth アプリケーションの作成).
Events	UPDATE	rw_events NOTE: CData's embedded OAuth application does not support this scope. You must create a custom OAuth application and request access for Events Management API from the list of products (see カスタムOAuth アプリケーションの作成).
CreateEvent	EXECUTE	rw_events
CompanyDetails	SELECT	r_organization_admin
CompanyFollowerStatistics	SELECT	r_organization_admin
CompanyList	SELECT	r_organization_admin
CompanyPageStatistics	SELECT	r_organization_admin
CompanyUpdateStatistics	SELECT	r_organization_admin
Documents	SELECT	r_organization_social
GeoLocation	SELECT	-
Images	SELECT	r_organization_social
Industries	SELECT	-
OrganizationAuthorizationActions	SELECT	rw_organization_admin
OrganizationFollowerCount	SELECT	-
OrganizationLocations	SELECT	r_organization_admin
Organizations	SELECT	r_organization_admin
Profiles	SELECT	r_basicprofile
Videos	SELECT	r_organization_social
VideoTimeWatchedForVideoViewsStatistics	SELECT	r_organization_social
VideoTimeWatchedStatistics	SELECT	r_organization_social
VideoViewerStatistics	SELECT	r_organization_social
VideoViewStatistics	SELECT	r_organization_social
DownloadAsset	EXECUTE	r_organization_social
UploadDocument	EXECUTE	w_organization_social
UploadImage	EXECUTE	w_organization_social
UploadVideo	EXECUTE	w_organization_social
UploadVideoCaptions	EXECUTE	-
UploadVideoThumbnail	EXECUTE	-

エンドポイントドメインについて

エンドポイントドメインとは、アプリケーションが認証、レコードの取得、その他の重要な操作を実行するために通信する必要がある特定のURL を指します。

これらのドメインを許可することで、アプリケーションとAPI 間のネットワークトラフィックがファイアウォールやセキュリティ設定によってブロックされることがなくなります。

Note： ほとんどのユーザーは特別な設定をする必要はありません。許可リストは通常、送信ネットワークトラフィックの制限など、厳格なセキュリティ対策が施された環境でのみ必要となります。

LinkedIn に必要なエンドポイントドメイン

Domain	Always Required	Description
linkedin.com	True	The main domain used for accessing the main LinkedIn API-s that the Sync App uses.
licdn.com	False	The domain used for downloading LinkedIn assets through its CDN such as Images or Videos (see DownloadAsset as well).

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

ユーザー定義ビュー

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

SSL の設定

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

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

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

クエリ処理

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

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

ログ

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

SSL 設定のカスタマイズ

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

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

Firewall またはProxy 経由の接続

HTTP プロキシ

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

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

その他のプロキシ

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

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

CData Sync App は、LinkedIn API のエンティティをテーブル、ビュー、およびストアドプロシージャにモデル化します。これらはスキーマファイルに定義されています。テキストベースのシンプルな設定ファイルです。 Sync App は、LinkedIn API を使用してサポートされているフィルタを処理します。その他のフィルタは、Sync App 内でクライアント側で処理されます。

ビュー

ビュー は変更ができないテーブルです。一般的に、読み取り専用のデータはビューとして表示されます。

ストアドプロシージャ

ストアドプロシージャ は、データソースへの関数形式のインターフェースです。これらを使用して、データソース内の情報を検索、更新、および変更できます。

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

LinkedIn Connector for CData Sync テーブル

Name	Description
Comments	Query Comments data for Posts in the Organization Pages that you administer.
CompanyStatusUpdates	Read and write posts in your organizations.
Events	Read and update events in your organizations.

Query Comments data for Posts in the Organization Pages that you administer.

Select

The Comments table supports filtering in the WHERE clause using the Id column with only the = operator, and for the UpdateId column with both the = and IN operators. The = operator is fully supported server-side, whereas the IN operator is partially supported server-side and partially client-side. Refer to the query examples below:

SELECT * FROM Comments WHERE Id = 7155174232715386880 and UpdateId = 'urn:li:share:7155174232715386880';
SELECT * FROM Comments WHERE UpdateId = 'urn:li:share:7155174232715386880';
SELECT * FROM Comments WHERE UpdateId IN ('urn:li:share:7155174232715386880', 'urn:li:share:7165681621608738816');

The following query returns the data for the columns we expose in the view, for each Post in each Organization Page that the user administers.

SELECT * FROM Comments;

To retrieve information on Posts in your Organization Pages, use CompanyStatusUpdates.

Insert

The Comments table supports creating new comments on the posts of the organization pages that the user administers. For successful creation, you will need to specify the UpdateId and Text parameters. If the CreatedBy parameter isn’t filled, the driver will use the URN of the authenticated user or the URN of the company if the CompanyId connection property is specified. Refer to examples below:

INSERT INTO Comments (UpdateId, Text) VALUES ('urn:li:share:7155174232715386880', 'Test Comment')
INSERT INTO Comments (UpdateId, Text, CreatedBy) VALUES ('urn:li:share:7155174232715386880', 'Test Comment', 'urn:li:organisation:101877555')

Update

The Comments table supports updating the content of the comments on the posts of the organization pages that the user administers. Only the Text field is updatable.

UPDATE Comments SET Text = 'Test Comment' WHERE Id = 715517423271578940
UPDATE Comments SET Text = 'Test Comment' WHERE Id = 715517423271578940 AND UpdateId = 'urn:li:share:7155174232715386880'

Delete

The Comments table supports removing comments from the posts of the organization pages that the user administers.

DELETE FROM Comments WHERE Id = 715517423271578940
DELETE FROM Comments WHERE Id = 715517423271578940 AND UpdateId = 'urn:li:share:7155174232715386880'

Columns

Name	Type	ReadOnly	References	Description
Id [KEY]	String	True		The unique identifier for the comment.
UpdateId	String	False		The identifier for the update associated with the comment.
Text	String	False		The content of the comment regarding the update.
CreatedBy	String	False		The unique identifier for the person or company.
Date	Datetime	True		The date or timestamp when the comment was last modified.
Mentions	String	True		The Uniform Resource Names (URNs) for the organizations or individuals mentioned in the comment.

Read and write posts in your organizations.

Table-specific Information

Select

For the CompanyId column, the = operator is fully supported server-side. Refer to the query examples below:

SELECT * FROM CompanyStatusUpdates WHERE CompanyId = '183432'

Insert

The CompanyStatusUpdates table supports creating new posts in the organization pages that you administer. The following columns are required when creating a new post:

• Comment
• CreatedBy
• Visibility
• LifecycleState

Refer to the query examples below:

INSERT INTO CompanyStatusUpdates(Comment, CreatedBy, Visibility, LifecycleState, IsReshareDisabled) VALUES('Test Post', 'urn:li:organization:101409996', 'PUBLIC', 'DRAFT', true);

Update

The CompanyStatusUpdates table supports updating the posts in the organization pages that you administer. Only the following columns can be updated:

• Comment
• LifecycleState

The Id column must be specified in the criteria. Refer to the query examples below:

UPDATE CompanyStatusUpdates SET Comment = 'My Post', LifecycleState = 'PUBLISHED' WHERE Id = 'urn:li:share:7383870244806791168'

Delete

The CompanyStatusUpdates table supports deleting the posts in the organization pages that you administer. The Id column must be specified in the criteria. Refer to the query examples below:

DELETE FROM CompanyStatusUpdates WHERE Id = 'urn:li:share:7383870244806791168'

Columns

Name	Type	ReadOnly	References	Description
Id [KEY]	String	True		Unique identifier for the post.
Comment	String	False		Text comment associated with the post.
CompanyId	String	True		Identifier of the company to which the post belongs.
Date	Datetime	True		Timestamp when the post was created.
CreatedBy	String	False		Identifier of the user who created the post.
FirstPublishedAt	Datetime	True		Timestamp when the post was published.
LastModified	Datetime	True		Timestamp when the post most last modified.
Visibility	String	False		Specifies who can view the post. 使用できる値は次のとおりです。CONNECTIONS, PUBLIC, LOGGED_IN
LifecycleState	String	False		Current lifecycle state of the post. 使用できる値は次のとおりです。DRAFT, PUBLISHED, PUBLISH_REQUESTED, PUBLISH_FAILED
Content	String	False		Main content of the post.
ContentCTALabel	String	True		The call-to-action label used in the post's content. 使用できる値は次のとおりです。APPLY, DOWNLOAD, VIEW_QUOTE, LEARN_MORE, SIGN_UP, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, SEE_MORE, BUY_NOW, SHOP_NOW
IsReshareDisabled	Boolean	False		Indicates if the author has disabled re-sharing for the post.
ParentPostURN	String	False	CompanyStatusUpdates.Id	URN of the parent post if the post is a re-share.
RootPostURN	String	True	CompanyStatusUpdates.Id	URN of the root post in the re-share chain if the post is a re-share.

Read and update events in your organizations.

Table-specific Information

Select

The = operator is fully supported server-side for the OrganizerURN column. The IN operator is partially supported server-side. Refer to the query examples below:

SELECT * FROM Events WHERE OrganizerURN = 'urn:li:organization:4975021'
SELECT * FROM Events WHERE OrganizerURN IN ('urn:li:organization:4975021', 'urn:li:organization:6554901')

When the OrganizerURN column is not specified in the criteria as in the example below:

SELECT * FROM Events

the Sync App internally transforms the query to the following before executing:

SELECT * FROM Events WHERE OrganizerURN IN (SELECT Id FROM CompanyList WHERE State = 'APPROVED' AND Role = 'ADMINISTRATOR')

Update

When updating events, the Id column must be specified in the criteria as in the query example below:

UPDATE Events SET VanityName = 'mytestevent7382067115601719297456' WHERE Id = '7382067115601719297456'

Deleting Events

To delete an event, delete its corresponding post. You can delete posts in your organization by executing DELETE statements on the CompanyStatusUpdates table.

Columns

Name	Type	ReadOnly	References	Description
Id [KEY]	String	True		Unique identifier for the event.
URN	String	True		URN of the event.
OrganizerURN	String	True		URN of the event organizer.
Name	String	True		Name of the event.
Description	String	True		Detailed description of the event.
Type	String	True		Type or category of the event. Data is returned in JSON format.
VanityName	String	False		Custom or user-friendly name for the event.
StartsAt	Datetime	True		Timestamp when the event starts.
BackgroundImageURN	String	True		URN of the event's background image.
LeadFormURN	String	True		URN of the lead generation form associated with the event.
DiscoveryMode	String	True		How the event is discovered or promoted.
PostURN	String	True	CompanyStatusUpdates.Id	URN of the post associated with the event.
CreatedBy	String	True		URN of the actor who created the event.
CreatedAt	Datetime	True		Timestamp when the event was created.
LastUpdatedBy	String	True		URN of the actor who last updated the event.
LastUpdatedAt	Datetime	True		Timestamp when the event was last updated.

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

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

LinkedIn Connector for CData Sync ビュー

Name	Description
CompanyDetails	Retrieve company profiles and updates.
CompanyFollowerStatistics	Query statistics about followers for a particular company page.
CompanyList	Lists all companies and the privileges that the user has within the organization.
CompanyPageStatistics	Query statistics about page views for a particular company page.
CompanyUpdateStatistics	Query update statistics about a company. If the TimeRange filters are not specified, the default result set is for the last 12 months.
Documents	Read the metadata of the document assets created in the organizations you administer.
GeoLocation	Provides the display name for a given geo Id, or a set of geo Ids.
Images	Read the metadata of the image assets created in the organizations you administer.
Industries	Query the list of available industries in LinkedIn.
OrganizationAuthorizationActions	Read data on the authorization action assignments for the organizations in which you are a member.
OrganizationFollowerCount	The Organization Follower Count View provides the ability to retrieve the number of first-degree connections (followers) for the organization defined in the CompanyId connection string property.
OrganizationLocations	Retrieve location information for any LinkedIn organization, regardless of whether you manage that organization.
Organizations	Query information about any LinkedIn organization, regardless of whether the individual is an administrator for that organization.
Profiles	Retrieves LinkedIn member profile information.
Videos	Read the metadata of the video assets created in the organizations you administer.
VideoTimeWatchedForVideoViewsStatistics	Query statistics about the time watched in milliseconds for video.
VideoTimeWatchedStatistics	Query statistics about the time the video was watched in milliseconds.
VideoViewerStatistics	Query statistics about unique viewers who made engaged plays on the video.
VideoViewStatistics	Query statistics about video views for a particular company page.

Retrieve company profiles and updates.

Select

The CompanyDetails view supports only the CompanyId column in the WHERE clause. The only supported operator for the CompanyId column is =. For example:

SELECT * FROM CompanyDetails WHERE CompanyId = '183432'

Columns

Name	Type	References	Description
CompanyId [KEY]	String		The unique, internal, numeric identifier for the company in the following format urn:li:organization:{id}
CompanyName	String		The name of the company.
UniversalName	String		The unique string identifier for the company.
Description	String		The company description. Limit of 500 characters.
Specialties	String		The company specialties.
StaffCountRange	String		The company staff count range.
WebsiteUrl	String		The URL for the company website.
Logo	String		The original company logo.
SquareLogo	String		The square company logo.
CompanyTypeName	String		The name of the company type.
Groups	String		The groups of the company.
Industries	String		The industries of the company.
FoundedYear	Integer		The year the company was founded.
PrimaryOrganizationType	String		Type of primary organization being used in the lookup. Possible values: SCHOOL,BRAND,NONE
VanityName	String		Entity's unique name used in URLs.
VersionTag	String		Tag indicating version.

Query statistics about followers for a particular company page.

Select

The Sync App uses the LinkedIn API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the Sync App.

• CompanyId supports only the '=' operator.
• TimeGranularity supports only the '=' operator.
• ReportTimeRangeStart supports only the '=' operator.
• ReportTimeRangeEnd supports only the '=' operator.

For example, the following queries are processed server side:

SELECT * FROM CompanyFollowerStatistics WHERE CompanyId = '183432'
SELECT * FROM CompanyFollowerStatistics WHERE ReportTimeRangeStart = '2019-10-20' AND ReportTimeRangeEnd = '2020-10-15'
SELECT * FROM CompanyFollowerStatistics WHERE ReportTimeRangeStart = '2019-10-15' AND TimeGranularity = 'DAY'
SELECT * FROM CompanyFollowerStatistics WHERE TimeGranularity = 'MONTH' AND ReportTimeRangeStart = '2019-10-15' AND ReportTimeRangeEnd = '2020-10-15' AND CompanyId = '10904095'

Time-Based Data Queries

The three inputs that control time-based data queries are TimeGranularity, TimeRangeStart, and TimeRangeEnd. TimeGranularity is not always required, but if it is specified you must also specify TimeRange Start, TimeRangeEnd, or both.

The behavior of TimeGranularity in a query depends on what other inputs are specified.

Inputs specified	Result
None	The driver returns all data from the time the company page was created until the present time, in one record.
TimeRangeStart only (no TimeRangeEnd or TimeGranularity)	The driver returns all data from the time specified in TimeRangeStart until the present time, in one record.
TimeRangeStart and TimeRangeEnd (no TimeRangeGranularity)	The driver returns all data from the time specified in TimeRangeStart until the time specified in TimeRangeEnd, in one record. If the value specified in TimeRangeStart is older than the time when the page was created, it retrieves all data from the time the page was created to the time specified in TimeRangeEnd.
TimeRangeEnd only (no TimeRangeStart or TimeGranularity)	The driver returns all data from the time the company page was created, until the time specified in TimeRangeEnd, in one record.
All	The driver breaks down the data into multiple records with different time intervals: one record for every day/month beginning from TimeRangeStart until TimeRangeEnd, depending on the value specified in TimeGranularity.

Columns

Name	Type	References	Description
CompanyId	String		Id of the Company associated with the follow statistics in the following format urn:li:organization:{id}.
Category	String		The category of the followers.
Type	String		Type of the category.
OrganicFollowerCount	Integer		Total number of the organinc followers.
PaidFollowerCount	Integer		Total number of the paid followers.
TimeGranularity	String		Granularity of the statistics. Must be either DAY or MONTH.
ReportTimeRangeStart	Datetime		Exclusive starting timestamp of when the query should begin. Queries from beginning of time when not set.
ReportTimeRangeEnd	Datetime		Inclusive ending timestamp of when the query should end. Queries until current time when not set.
UsageStartTime	Datetime		Date start covered by the report data point. Refer to the ReportTimeRangeStart column for the start date of the range covered by the complete report.
UsageEndTime	Datetime		Date end covered by the report data point. Refer to the ReportTimeRangeEnd column for the end date of the range covered by the complete report.

Lists all companies and the privileges that the user has within the organization.

Select

The Sync App uses the LinkedIn API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the Sync App.

• Role supports only the '=' and IN operators.
• State supports only the '=' and IN operators.

The following query returns a list of all companies that the corresponding member is an administrator of:

SELECT * FROM CompanyList

The following queries are processed server side:

SELECT * FROM CompanyList Role = 'ANALYST';
SELECT * FROM CompanyList WHERE State IN ('APPROVED', 'REQUESTED');
SELECT * FROM CompanyList WHERE State = 'APPROVED' AND Role = 'ADMINISTRATOR';

Columns

Name	Type	References	Description
Id	String		A unique identifier for the company in the following format urn:li:organization:{id}
RoleAssignee	String		Id of the assigned person.
Role	String		Role of the assigned person. Possible values are: ADMINISTRATOR, DIRECT_SPONSORED_CONTENT_POSTER, RECRUITING_POSTER, LEAD_CAPTURE_ADMINISTRATOR, LEAD_GEN_FORMS_MANAGER, ANALYST, CURATOR, CONTENT_ADMINISTRATOR.
State	String		State of the role assigned to the person. Possible values are: APPROVED, REJECTED, REQUESTED, REVOKED.

Query statistics about page views for a particular company page.

Select

The Sync App uses the LinkedIn API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the Sync App.

• CompanyId supports only the '=' operator.
• TimeGranularity supports only the '=' operator.
• ReportTimeRangeStart supports only the '=' operator.
• ReportTimeRangeEnd supports only the '=' operator.

The CompanyPageStatistics view allows you to retrieve both lifetime and time-bound statistics on views and clicks for an organization page.

• Lifetime page statistics: To retrieve lifetime page statistics, do not set the ReportTimeRangeStart and ReportTimeRangeEnd in the WHERE clause conditions. The API returns view and click statistics segmented by various facets. For example:
  

  SELECT * FROM [CompanyPageStatistics]

• Time-bound page statistics: To retrieve time-bound page statistics, include the ReportTimeRangeStart and/or ReportTimeRangeEnd in the WHERE clause conditions. The API returns aggregate page statistics within all of the days or months in between the selected date range based on the specified TimeGranularity (DAY or MONTH). For example:
  

  SELECT * FROM [CompanyPageStatistics] WHERE ReportTimeRangeStart = '2019-10-20' AND ReportTimeRangeEnd = '2020-10-15'
  
  SELECT * FROM [CompanyPageStatistics] WHERE ReportTimeRangeStart = '2019-10-15' AND TimeGranularity = 'DAY'
  
  SELECT * FROM [CompanyPageStatistics] WHERE TimeGranularity = 'MONTH' AND ReportTimeRangeStart = '2019-10-15' AND ReportTimeRangeEnd = '2020-10-15' AND companyId = '10904095'

Time-Based Data Queries

The three inputs that control time-based data queries are TimeGranularity, TimeRangeStart, and TimeRangeEnd. TimeGranularity is not always required, but if it is specified you must also specify TimeRange Start, TimeRangeEnd, or both.

The behavior of TimeGranularity in a query depends on what other inputs are specified.

Inputs specified	Result
None	The driver returns all data from the time the company page was created until the present time, in one record.
TimeRangeStart only (no TimeRangeEnd or TimeGranularity)	The driver returns all data from the time specified in TimeRangeStart until the present time, in one record.
TimeRangeStart and TimeRangeEnd (no TimeRangeGranularity)	The driver returns all data from the time specified in TimeRangeStart until the time specified in TimeRangeEnd, in one record. If the value specified in TimeRangeStart is older than the time when the page was created, it retrieves all data from the time the page was created to the time specified in TimeRangeEnd.
TimeRangeEnd only (no TimeRangeStart or TimeGranularity)	The driver returns all data from the time the company page was created, until the time specified in TimeRangeEnd, in one record.
All	The driver breaks down the data into multiple records with different time intervals: one record for every day/month beginning from TimeRangeStart until TimeRangeEnd, depending on the value specified in TimeGranularity.

Columns

Name	Type	References	Description
CompanyId	String		Id of the Company associated with the page statistics in the following format urn:li:organization:{id}
Category	String		The category of the statistics.
Type	String		Type of the category. Not applicable for the totalPageStatistics category.
AllPageViews	Integer		Complete page views count. The reported counts may be higher because they include comprehensive mobile and desktop traffic.
AllDesktopPageViews	Integer		Complete desktop page views count.
AllMobilePageViews	Integer		Complete mobile page views count.
OverviewPageViews	Integer		Total Overview page views count. The reported counts may be higher because they include comprehensive mobile and desktop traffic.
CareersPageViews	Integer		Total Careers page views count.
DesktopCareersPageViews	Integer		Total desktop Careers page views count.
DesktopJobsPageViews	Integer		Total desktop Jobs page views count.
DesktopLifeAtPageViews	Integer		Total desktop Life Atpage views count.
DesktopOverviewPageViews	Integer		Total desktop Overview page views count.
JobsPageViews	Integer		Total Jobs page views count.
LifeAtPageViews	Integer		Total LifeAt page views count.
MobileCareersPageViews	Integer		Total mobile Careers page views count.
MobileJobsPageViews	Integer		Total mobile Jobs page views count.
MobileLifeAtPageViews	Integer		Total mobile LifeAt Page views count.
MobileOverviewPageViews	Integer		Total mobile Overview page views count.
MobileProductsPageViews	Integer		Total mobile Products page views count.
InsightsPageViews	Integer		Total Insights page views count.
MobileAboutPageViews	Integer		Total mobile About page views count.
ProductsPageViews	Integer		Total Products page views count.
DesktopProductsPageViews	Integer		Total desktop Products page views count.
PeoplePageViews	Integer		Total People page views count.
DesktopPeoplePageViews	Integer		Total desktop People page views count.
AboutPageViews	Integer		Total About page views count.
DesktopAboutPageViews	Integer		Total desktop About page views count.
MobilePeoplePageViews	Integer		Total mobile People page views count.
DesktopInsightsPageViews	Integer		Total desktop Insights page views count.
MobileInsightsPageViews	Integer		Total mobile Insights page views count.
MobileCareersPagePromoLinksClicks	Integer		Total mobile clicks count on Careers page promo links. Applicable only for the totalPageStatistics category.
MobileCareersPageJobsClicks	Integer		Total mobile clicks count on Careers page Jobs. Applicable only for the totalPageStatistics category.
MobileCareersPageEmployeesClicks	Integer		Total mobile clicks count on Careers page Employees. Applicable only for the totalPageStatistics category.
CareersPagePromoLinksClicks	Integer		Total clicks count on Careers page promo links. Applicable only for the totalPageStatistics category.
CareersPageBannerPromoClicks	Integer		Total clicks count on Careers page banner promo. Applicable only for the totalPageStatistics category.
CareersPageJobsClicks	Integer		Total clicks count on Careers page jobs. Applicable only for the totalPageStatistics category.
CareersPageEmployeesClicks	Integer		Total clicks count on Careers page employees. Applicable only for the totalPageStatistics category.
TimeGranularity	String		Granularity of the statistics. Must be either DAY or MONTH.
UsageStartTime	Datetime		Date start covered by the report data point. Refer to the ReportTimeRangeStart column for the start date of the range covered by the complete report.
UsageEndTime	Datetime		Date end covered by the report data point. Refer to the ReportTimeRangeEnd column for the end date of the range covered by the complete report.
ReportTimeRangeStart	Datetime		Exclusive starting timestamp of when the query should begin. Queries from beginning of time when not set.
ReportTimeRangeEnd	Datetime		Inclusive ending timestamp of when the query should end. Queries until current time when not set.

Query update statistics about a company. If the TimeRange filters are not specified, the default result set is for the last 12 months.

Select

The Sync App uses the LinkedIn API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the Sync App.

• CompanyId supports only the '=' operator.
• TimeGranularity supports only the '=' operator.
• TimeRangeStart supports only the '=' operator.
• TimeRangeEnd supports only the '=' operator.
• UGCPostId supports the '=,IN' comparisons.

For example, the following queries are processed server side:

SELECT * FROM CompanyUpdateStatistics WHERE TimeRangeStart = '2019-10-20' AND TimeRangeEnd = '2020-10-15'
SELECT * FROM CompanyUpdateStatistics WHERE TimeRangeStart = '2019-10-15' AND TimeGranularity = 'DAY'
SELECT * FROM CompanyUpdateStatistics WHERE TimeGranularity = 'MONTH' AND TimeRangeStart = '2019-10-15' AND TimeRangeEnd = '2020-10-15' AND CompanyId = '10904095'
SELECT * FROM CompanyUpdateStatistics WHERE CompanyId = '183432'
SELECT * FROM CompanyUpdateStatistics WHERE UGCPostId = 'urn:li:ugcPost:1234'
SELECT * FROM CompanyUpdateStatistics WHERE UGCPostId IN ('urn:li:ugcPost:1234', 'urn:li:ugcPost:2345')

Time-Based Data Queries

The three inputs that control time-based data queries are TimeGranularity, TimeRangeStart, and TimeRangeEnd. TimeGranularity is not always required, but if it is specified you must also specify TimeRange Start, TimeRangeEnd, or both.

The behavior of TimeGranularity in a query depends on what other inputs are specified.

Inputs specified	Result
None	The driver returns all data from the time the company page was created until the present time, in one record.
TimeRangeStart only (no TimeRangeEnd or TimeGranularity)	The driver returns all data from the time specified in TimeRangeStart until the present time, in one record.
TimeRangeStart and TimeRangeEnd (no TimeRangeGranularity)	The driver returns all data from the time specified in TimeRangeStart until the time specified in TimeRangeEnd, in one record. If the value specified in TimeRangeStart is older than the time when the page was created, it retrieves all data from the time the page was created to the time specified in TimeRangeEnd.
TimeRangeEnd only (no TimeRangeStart or TimeGranularity)	The driver returns all data from the time the company page was created, until the time specified in TimeRangeEnd, in one record.
All	The driver breaks down the data into multiple records with different time intervals: one record for every day/month beginning from TimeRangeStart until TimeRangeEnd, depending on the value specified in TimeGranularity.

Columns

Name	Type	References	Description
Clicks	Integer		Total clicks count.
Comments	Integer		Total comments count.
CommentMentions	Integer		Total comment mentions count.
Engagement	Double		Total engagement count.
Impressions	Integer		Total impressions count.
Likes	Integer		Total likes count.
Shares	Integer		Total shares count.
ShareMentions	Integer		Total share mentions count.
UniqueImpressions	Integer		Total share mentions count.
TimeRangeStart	Datetime		Exclusive starting datetime of when the query should begin. When not set, queries from the beginning of time.
TimeRangeEnd	Datetime		Inclusive ending datetime of when the query should end. When not set, queries until the current time.
TimeGranularity	String		Granularity of the statistics. Must be either DAY or MONTH. Requires TimeRangeStart and TimeRangeEnd.
UGCPostId	String		The ID of the UGC post.
ShareId	String		The ID of the share.
CompanyId	String	CompanyList.Id	Id of the Company associated with the update statistics.
IntervalStartTime	Datetime		Date start covered by the report data point. For start date of the range covered by the complete report, see the TimeRangeStart column.
IntervalEndTime	Datetime		Date end covered by the report data point. For the end date of the range covered by the complete report, see the TimeRangeEnd column.

Read the metadata of the document assets created in the organizations you administer.

Table Specific Information

Select

The URN column is required and must be specified in the criteria to query data from this table.

For the URN column, the = operator is fully supported server-side. The IN operator is partially supported server-side and partially client-side. Refer to the query examples below:

SELECT * FROM Documents WHERE URN = 'urn:li:document:D4D10AQGFjOtqZWBMww';
SELECT * FROM Documents WHERE URN IN ('urn:li:document:D4D10AQGFjOtqZWBMww', 'urn:li:document:D4D10AQFVYoDpcZs86Q')

The rest of the query is processed client-side.

Columns

Name	Type	References	Description
URN [KEY]	String		The URN of the document.
OwnerURN	String		The URN of the entity who owns the document.
DownloadURL	String		The URL for downloading the document.
DownloadURLExpiresAt	Datetime		The time when the URL for downloading the document expires.
Status	String		The status of the document. 使用できる値は次のとおりです。PROCESSING, PROCESSING_FAILED, AVAILABLE, WAITING_UPLOAD

Provides the display name for a given geo Id, or a set of geo Ids.

GeoLocation requires an Id in SELECT statements. For example:

SELECT * FROM geolocation where id = 'urn:li:geo:123456'

To specify multiple geolocation Ids use the IN operator:

SELECT * FROM geolocation WHERE id IN (<List of geolocation ids>)

Columns

Name	Type	References	Description
Id [KEY]	String		Unique identifier for the entity. Can be a single Id or a comma-separated list of Ids.
Country	String		An uppercase two-letter country code as defined by ISO-3166.
Language	String		A lowercase two-letter language code as defined by ISO-639.
Value	String		The value of the display text.

Pseudo-Columns

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

Name	Type	Description
LocaleLanguage	String		The locale language the country data is requested in. A lowercase two-letter language code as defined by ISO-639. デフォルト値はenです。
LocaleCountry	String		The locale country the country data is requested in. An uppercase two-letter country code as defined by ISO-3166. デフォルト値はUSです。

Read the metadata of the image assets created in the organizations you administer.

Table Specific Information

Select

The URN column is required and must be specified in the criteria to query data from this table.

For the URN column, the = operator is fully supported server-side. The IN operator is partially supported server-side and partially client-side. Refer to the query examples below:

SELECT * FROM Images WHERE URN = 'urn:li:image:D4D10AQHqn3iVssgwvA';
SELECT * FROM Images WHERE URN IN ('urn:li:image:D4D10AQHqn3iVssgwvA', 'urn:li:image:D4D10AQGGB-vB21hq4g')

The rest of the query is processed client-side.

Columns

Name	Type	References	Description
URN [KEY]	String		The URN of the image.
OwnerURN	String		The URN of the entity who owns the image.
DownloadURL	String		The URL for downloading the image.
DownloadURLExpiresAt	Datetime		The time when the URL for downloading the image expires.
Status	String		The status of the image. 使用できる値は次のとおりです。PROCESSING, PROCESSING_FAILED, AVAILABLE, WAITING_UPLOAD

Query the list of available industries in LinkedIn.

Columns

Name	Type	References	Description
Id [KEY]	Integer		The identifier of the industry.
Name	String		The name of the industry.
URN	String		The URN of the industry.
ParentId	Integer	Industries.Id	The identifier of the parent industry of this industry.

Read data on the authorization action assignments for the organizations in which you are a member.

Table-specific Information

Select

The AuthorizationAction column must be specified in the criteria to read data from this view. The = and IN operators are fully supported server-side for this column. Refer to the query examples below:

SELECT * FROM OrganizationAuthorizationActions WHERE AuthorizationAction = 'organizationRoleAuthorizationAction:(actionType:ADMINISTRATOR_READ)'
SELECT * FROM OrganizationAuthorizationActions WHERE AuthorizationAction IN ('organizationRoleAuthorizationAction:(actionType:ADMINISTRATOR_READ)', 'organizationRoleAuthorizationAction:(actionType:ADMINISTRATOR_WRITE)')

The values to use for the AuthorizationAction column must be in exactly the following format:

{ACTION}:(actionType:{TYPE})

Additionally, the casing used for these values matters. The {ACTION} part must be in camel case (for example: 'organizationRoleAuthorizationAction') and the {TYPE} part must be in all-caps snake case (for example: 'ADMINISTRATOR_READ'). Refer to LinkedIn's API documentation for the values to use for the {ACTION} and {TYPE} placeholders.

The = operator is fully supported server-side for the OrganizationURN and MemberURN columns (composite key). The IN operator is partially supported server-side. Refer to the query examples below:

SELECT * FROM OrganizationAuthorizationActions WHERE (OrganizationURN, MemberURN) = ('urn:li:organization:4975021', 'urn:li:person:XXXXXXXXXX') AND AuthorizationAction = 'organizationRoleAuthorizationAction:(actionType:ADMINISTRATOR_READ)'
SELECT * FROM OrganizationAuthorizationActions WHERE (OrganizationURN, MemberURN) IN (('urn:li:organization:4975021', 'urn:li:person:XXXXXXXXXX'), ('urn:li:organization:6554901', 'urn:li:person:YYYYYYYYYY')) AND AuthorizationAction IN ('organizationRoleAuthorizationAction:(actionType:ADMINISTRATOR_READ)', 'organizationRoleAuthorizationAction:(actionType:ADMINISTRATOR_WRITE)')

When the OrganizationURN and MemberURN columns are not specified in the criteria as in the example below:

SELECT * FROM OrganizationAuthorizationActions WHERE AuthorizationAction = 'organizationRoleAuthorizationAction:(actionType:ADMINISTRATOR_READ)'

we internally transform the query to the following before executing:

SELECT * FROM OrganizationAuthorizationActions WHERE (OrganizationURN, MemberURN) IN (SELECT Id, RoleAssignee FROM CompanyList WHERE State='APPROVED' AND Role='ADMINISTRATOR') AND AuthorizationAction = 'organizationRoleAuthorizationAction:(actionType:ADMINISTRATOR_READ)'

Columns

Name	Type	References	Description
OrganizationURN [KEY]	String		Unique identifier of the organization.
MemberURN [KEY]	String		Unique profile identifier of the member assigned the authorization action.
AuthorizationAction [KEY]	String		Authorization action assigned to the member for organization management.
Status	String		Status of the authorization action assignment.

The Organization Follower Count View provides the ability to retrieve the number of first-degree connections (followers) for the organization defined in the CompanyId connection string property.

Columns

Name	Type	References	Description
FirstDegreeSize	Integer		The number of first-degree connections (followers) for the organization.

Retrieve location information for any LinkedIn organization, regardless of whether you manage that organization.

Select

To use this view, you must specify either the OrganizationId or OrganizationVanityName columns. If you specify both columns with an AND clause, the OrganizationId criterion takes precedence over OrganizationVanityName. You cannot use the OR logical operator with criteria involving columns other than OrganizationId or OrganizationVanityName.

Refer to the query examples below:

SELECT * FROM OrganizationLocations WHERE OrganizationId = '4975021';
SELECT * FROM OrganizationLocations WHERE OrganizationId IN ('4975021', '6554901');
SELECT * FROM OrganizationLocations WHERE OrganizationVanityName IN ('CDataSoftware', 'OtherOrganization');

Columns

Name	Type	References	Description
OrganizationId	String	Organizations.Id	The identifier of the organization.
OrganizationVanityName	String		The vanity name of the organization.
GeoLocationURN [KEY]	String		The geolocation URN of the organization's location.
LocationType	String		The type of the organization's location.
Description	String		The description of the organization's location.
StaffCountRange	String		The range of staff members of the organization's location.
AddressLine1	String		The first line of the address of the organization's location.
AddressLine2	String		The second line of the address of the organization's location.
City	String		The city of the organization's location.
AdministrativeUnit	String		This refers to the administrative unit (e.g. state, country, province) of the organization's location.
PostalCode	String		The postal code of the organization's location.
Country	String		The country of the organization's location.

Query information about any LinkedIn organization, regardless of whether the individual is an administrator for that organization.

Select

This view differs from CompanyDetails, because it only exposes Non-Admin Organization data. You can use it whether or not you own the organization. If you are an Organization Administrator and need access to full data beyond the Non-Admin set, use CompanyDetails instead.

You must specify either the Id or VanityName column in the criteria to use this view. If you specify both columns with an AND clause, the Id criterion takes precedence over VanityName. Additionally, you cannot use the OR logical operator with criteria that involve columns other than Id or VanityName.

The = and IN operators are fully supported server-side for the Id column. Refer to the query examples below:

SELECT * FROM Organizations WHERE Id = '4975021';
SELECT * FROM Organizations WHERE Id IN ('4975021', '6554901');

The = operator is fully supported server-side for the VanityName column, while the IN operator is processed client-side. The values specified in the criteria are case-insensitive. Refer to the query examples below:

SELECT * FROM Organizations WHERE VanityName = 'cdatasoftware';
SELECT * FROM Organizations WHERE VanityName IN ('CDataSoftware', 'OtherOrganization');

Columns

Name	Type	References	Description
Id [KEY]	String		The identifier of the organization.
Name	String		The name of the organization.
VanityName	String		The vanity name of the organization.
Website	String		The organization's website.
PrimaryType	String		The primary type of the organization.
LogoAssetURN	String		The digital media asset URN for the organization's logo.
HierarchyClassification	String		The classification for the school's hierarchy in case the organization is a school.
SchoolType	String		The type of school in case the organization is a school.
YearLevel	String		The classification of the length of the school's educational programs in case the organization is a school.

Retrieves LinkedIn member profile information.

Select

When querying Profiles with a criteria, Id is required and must be included in the criteria. The OR logical operator is not supported in the criteria for columns other than Id.

The = and IN operators are fully supported server-side for the Id column. Refer to the query examples below:

SELECT * FROM Profiles WHERE Id = 'XXXXXXXXXX';
SELECT * FROM Profiles WHERE Id IN ('XXXXXXXXXX', 'YYYYYYYYYY');

If no criteria is specified, as shown in the query below, the view returns the authenticated user's LinkedIn profile data.

SELECT * FROM Profiles;

Columns

Name	Type	References	Description
Id [KEY]	String		The unique identifier of the member's profile.
FirstName	String		The first name of the member's profile.
LastName	String		The last name of the member's profile.
MaidenName	String		The maiden name of the member's profile.
Headline	String		The headline of the member's profile. Often this is the job title.
VanityName	String		The vanity name of the member's profile.
PictureAssetURN	String		The digital media asset URN for the picture of the member's profile.
URN	String		URN of the member's profile.

Read the metadata of the video assets created in the organizations you administer.

Table Specific Information

Select

The URN column is required and must be specified in the criteria to query data from this table.

For the URN column, the = operator is fully supported server-side. The IN operator is partially supported server-side and partially client-side. Refer to the query examples below:

SELECT * FROM Videos WHERE URN = 'urn:li:video:D4D10AQGLvWblHowYUw';
SELECT * FROM Videos WHERE URN IN ('urn:li:video:D4D10AQGLvWblHowYUw', 'urn:li:video:D4D10AQFLAKXbRnqwLQ')

The rest of the query is processed client-side.

Columns

Name	Type	References	Description
URN [KEY]	String		The URN of the video.
OwnerURN	String		The URN of the entity who owns the video.
DownloadURL	String		The URL for downloading the video.
DownloadURLExpiresAt	Datetime		The time when the URL for downloading the video expires.
Status	String		The status of the video. 使用できる値は次のとおりです。PROCESSING, PROCESSING_FAILED, AVAILABLE, WAITING_UPLOAD
AspectRatioHeight	Decimal		The aspect ratio height of the video.
AspectRatioWidth	Decimal		The aspect ratio width of the video.
Duration	Long		The duration of the video.
ThumbnailDownloadURL	String		The URL for downloading the video's thumbnail.
CaptionsDownloadURL	String		The URL for downloading the video's captions.

Query statistics about the time watched in milliseconds for video.

Columns

Name	Type	References	Description
UGCPostId	String		Id of the Post associated with the video in the following format urn:li:ugcPost:{id}.
TimeWatchedForVideoViews	Long		The time watched in milliseconds for video play-pause cycles that are at least 3 seconds.
TimeGranularity	String		Granularity of the statistics. Can be DAY, WEEK, or ALL (default).
TimeRangeStart	Datetime		Exclusive starting timestamp of when the query should begin. Queries from beginning of time when not set.
TimeRangeEnd	Datetime		Inclusive ending timestamp of when the query should end. Queries until current time when not set.
IntervalStartTime	Datetime		Date start covered by the report data point. For start date of the range covered by the complete report, see the TimeRangeStart column.
IntervalEndTime	Datetime		Date end covered by the report data point. For the end date of the range covered by the complete report, see the TimeRangeEnd column.

Query statistics about the time the video was watched in milliseconds.

Columns

Name	Type	References	Description
UGCPostId	String		Id of the Post associated with the video in the following format urn:li:ugcPost:{id}.
TimeWatched	Long		The time the video was watched in milliseconds.
TimeGranularity	String		Granularity of the statistics. Can be DAY, WEEK, or ALL (default).
TimeRangeStart	Datetime		Exclusive starting timestamp of when the query should begin. Queries from beginning of time when not set.
TimeRangeEnd	Datetime		Inclusive ending timestamp of when the query should end. Queries until current time when not set.
IntervalStartTime	Datetime		Date start covered by the report data point. For start date of the range covered by the complete report, see the TimeRangeStart column.
IntervalEndTime	Datetime		Date end covered by the report data point. For the end date of the range covered by the complete report, see the TimeRangeEnd column.

Query statistics about unique viewers who made engaged plays on the video.

Columns

Name	Type	References	Description
UGCPostId	String		Id of the Post associated with the video in the following format urn:li:ugcPost:{id}.
Viewers	Long		Unique viewers who made engaged plays on the video.
TimeGranularity	String		Granularity of the statistics. Can be DAY, WEEK, or ALL (default).
TimeRangeStart	Datetime		Exclusive starting timestamp of when the query should begin. Queries from beginning of time when not set.
TimeRangeEnd	Datetime		Inclusive ending timestamp of when the query should end. Queries until current time when not set.
IntervalStartTime	Datetime		Date start covered by the report data point. For start date of the range covered by the complete report, see the TimeRangeStart column.
IntervalEndTime	Datetime		Date end covered by the report data point. For the end date of the range covered by the complete report, see the TimeRangeEnd column.

Query statistics about video views for a particular company page.

Columns

Name	Type	References	Description
UGCPostId	String		Id of the Post associated with the video in the following format urn:li:ugcPost:{id}.
Views	Long		Video views of the statistic.
TimeGranularity	String		Granularity of the statistics. Can be DAY, WEEK, or ALL (default).
TimeRangeStart	Datetime		Exclusive starting timestamp of when the query should begin. Queries from beginning of time when not set.
TimeRangeEnd	Datetime		Inclusive ending timestamp of when the query should end. Queries until current time when not set.
IntervalStartTime	Datetime		Date start covered by the report data point. For start date of the range covered by the complete report, see the TimeRangeStart column.
IntervalEndTime	Datetime		Date end covered by the report data point. For the end date of the range covered by the complete report, see the TimeRangeEnd column.

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

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

LinkedIn Connector for CData Sync ストアドプロシージャ

Name	Description
CreateEvent	Create a new event in a LinkedIn organization. Events can be used to promote gatherings, webinars, conferences, or other activities to your LinkedIn audience. Once created, the event can be shared as posts and tracked through analytics.

Create a new event in a LinkedIn organization. Events can be used to promote gatherings, webinars, conferences, or other activities to your LinkedIn audience. Once created, the event can be shared as posts and tracked through analytics.

Input

Name	Type	Required	Description
Name	String	True	The display name of the event. This is the primary title that will be shown to LinkedIn users when they view the event.
OrganizerURN	String	True	The URN of the organization or person organizing this event. This must be an entity you have administrative access to. For organization events, use format 'urn:li:organization:{id}'. For personal events, use 'urn:li:person:{id}'.
Type	String	True	The type of event being created. Use 'IN_PERSON' for physical events at a venue, or 'ONLINE_EXTERNAL' for virtual events hosted on external platforms (e.g., Zoom, Teams, webinar software). 使用できる値は次のとおりです。IN_PERSON, ONLINE_EXTERNAL
Description	String	False	A detailed description of the event. This can include the event agenda, what attendees will learn, speaker information, or any other relevant details to help users understand the event's purpose and value.
StartsAt	Datetime	True	The date and time when the event begins.
EndsAt	Datetime	False	The date and time when the event ends. Must be after the StartsAt time. If not provided, the event will not have a defined end time. Format as ISO 8601 datetime (e.g., '2024-12-25T16:00:00Z').
URL	String	False	The URL where the online event will be hosted or where users can find more information. Required for ONLINE_EXTERNAL events. For in-person events, this can be used to provide a registration or informational website.
LeadGenFormPrivacyPolicyUrl	String	False	The URL to your organization's privacy policy. This is displayed to users when they register for the event through a lead generation form, ensuring compliance with data protection regulations.
BackgroundImageURN	String	False	The URN of the image asset to use as the event's background image. Upload an image first using the UploadImage stored procedure with IsEventBackground=true to obtain a valid URN.
VenueDetails	String	False	Additional information about the event venue. For in-person events, this can include venue name, room number, parking instructions, or other location-specific details that complement the address information.
AddressLine1	String	False	The first line of the street address for in-person events. This typically includes the building number and street name (e.g., '123 Main Street').
AddressLine2	String	False	The second line of the street address for in-person events. This can include suite numbers, apartment numbers, building names, or other secondary address information (e.g., 'Suite 400').
AddressCity	String	False	The city where the in-person event will take place (e.g., 'San Francisco', 'New York').
AddressCountry	String	False	The country where the in-person event will take place. Use the two-letter ISO 3166-1 alpha-2 country code (e.g., 'US' for United States, 'GB' for United Kingdom, 'DE' for Germany).
AddressGeographicArea	String	False	The geographic region where the in-person event will take place (e.g., 'CA', 'NY').
AddressPostalCode	String	False	The postal code or ZIP code for the event venue's address.

Result Set Columns

Name	Type	Description
Id	String	The unique identifier of the newly created event. This ID can be used to reference the event in subsequent operations, such as updating event details or sharing the event in posts.

Download document, image, and video assets from your LinkedIn organization.

Procedure Specific Information

For document assets, LinkedIn returns the data in PDF format when downloading through this procedure.

Input

Name	Type	Required	Description
URN	String	True	The URN of the asset that you want to download. Must be one from the following types: 'urn:li:document:', 'urn:li:image:', 'urn:li:video:'.
LocalFile	String	False	The absolute path of the file in your system to use for downloading the asset.
Overwrite	Boolean	False	A boolean value indicating whether to overwrite the file in the path provided in the 'LocalFile' parameter if it already exists. デフォルト値はfalseです。

Result Set Columns

Name	Type	Description
Success	Boolean	A boolean value indicating whether the asset was downloaded successfully or not.
FileData	String	A Base64-encoded string containing the data of the asset downloaded. This will be returned only if both the 'LocalFile' parameter and the 'FileStream' parameter are not specified.

Gets the OAuth access token from LinkedIn.

Input

Name	Type	Required	Description
AuthMode	String	False	The type of authentication mode to use. The allowed values are APP, WEB.
Verifier	String	False	The verifier token returned by LinkedIn after using the URL obtained with GetOAuthAuthorizationURL. Required for only the Web AuthMode.
Scope	String	False	The scope or permissions you are requesting.
CallbackUrl	String	False	The URL the user will be redirected to after authorizing your application.
State	String	False	Indicates any state which may be useful to your application upon receipt of the response. Your application receives the same value it sent, as this parameter makes a round-trip to the LinkedIn authorization server and back. Uses include redirecting the user to the correct resource in your site, using nonces, and mitigating cross-site request forgery.

Result Set Columns

Name	Type	Description
OAuthAccessToken	String	The OAuth token.
ExpiresIn	String	The remaining lifetime for the access token in seconds.
OAuthRefreshToken	String	The OAuth refresh token.

Gets the LinkedIn authorization URL. Access the URL returned in the output in a Web browser. This requests the access token that can be used as part of the connection string to LinkedIn.

Input

Name	Type	Required	Description
CallbackUrl	String	False	The URL that LinkedIn will return to after the user has authorized your app.
Scope	String	False	The scope or permissions you are requesting.
State	String	False	Indicates any state which may be useful to your application upon receipt of the response. Your application receives the same value it sent, as this parameter makes a round-trip to the LinkedIn authorization server and back. Uses include redirecting the user to the correct resource in your site, using nonces, and mitigating cross-site request forgery.

Result Set Columns

Name	Type	Description
URL	String	The URL to be entered into a Web browser to obtain the verifier token and authorize the data provider with.

Refreshes the OAuth access token used for authentication with LinkedIn.

Input

Name	Type	Required	Description
OAuthRefreshToken	String	True	The refresh token returned from the original authorization code exchange.

Result Set Columns

Name	Type	Description
OAuthAccessToken	String	The authentication token returned from LinkedIn. This can be used in subsequent calls to other operations for this particular service.
OAuthRefreshToken	String	A token that may be used to obtain a new access token.
ExpiresIn	String	The remaining lifetime on the access token.

Upload document assets in your LinkedIn organization which can be used to create posts.

Procedure Specific Information

To use this stored procedure, exactly one of the following parameters must be specified (in addition to OwnerURN):

• LocalFile
• FileStream
• FileData

If no parameter is used, or more than one parameter is used, the procedure fails.

Below are some other restrictions for document assets:

1. The document's size can't exceed 100MB and 300 pages.
2. The following formats are supported: PPT, PPTX, DOC, DOCX, and PDF.

Input

Name	Type	Required	Description
OwnerURN	String	True	The URN of the organization to use as the new document's owner.
LocalFile	String	False	The absolute path of the document in your system to upload to LinkedIn.
FileData	String	False	A Base64-encoded string containing the data of the document to upload to LinkedIn. Useful in cases when neither the 'LocalFile' parameter nor the 'FileStream' parameter are viable options.

Result Set Columns

Name	Type	Description
DocumentURN	String	The URN of the new document asset that was created, if the upload was successful.

Upload image assets in your LinkedIn organization which can be used to create posts or events.

Procedure Specific Information

To use this stored procedure, exactly one of the following parameters must be specified (in addition to OwnerURN):

• LocalFile
• FileStream
• FileData

If no parameter is used, or more than one parameter is used, the procedure will fail.

Below are some other restrictions for image assets:

1. Only images with a total pixel count (width X height) less than 36,152,320 are allowed.
2. The following formats are supported: JPG, PNG, and GIF.
3. For the GIF format, up to 250 frames can be used.

Input

Name	Type	Required	Description
OwnerURN	String	True	The URN of the entity that will own the uploaded image asset. For event background images (when IsEventBackground=true), you must use a person URN (format: 'urn:li:person:{id}') representing your LinkedIn member account.
IsEventBackground	Boolean	False	Set this to true if the uploaded image will be used as an event background image. When true, the image is registered with specific dimensions and requirements for event headers. The resulting ImageURN can then be passed to the BackgroundImageURN parameter in the CreateEvent stored procedure. Event background images must be owned by a person URN, not an organization URN. デフォルト値はfalseです。
LocalFile	String	False	The absolute path of the image file in your system to upload to LinkedIn.
FileData	String	False	A Base64-encoded string containing the data of the image to upload to LinkedIn. Useful in cases when neither the 'LocalFile' parameter nor the 'FileStream' parameter are viable options.

Result Set Columns

Name	Type	Description
ImageURN	String	The URN of the new image asset that was created, if the upload was successful.

Upload video assets in your LinkedIn organization which can be used to create posts.

Procedure Specific Information

To use this stored procedure, exactly one of the following parameters must be specified (in addition to OwnerURN):

• LocalFile
• FileStream (if this used, the FileStreamSize parameter must also be specified)
• FileData

If no parameter is used, or more than one parameter is used, the procedure will fail.

If the video has a thumbnail, you can use the value returned in the ThumbnailUploadURL output parameter to upload the video's thumbnail through the UploadVideoThumbnail stored procedure.

If the video has captions, you can use the value returned in the CaptionsUploadURL output parameter to upload the video's captions through the UploadVideoCaptions stored procedure.

For a video asset to be usable (can be used to create posts), you must:

• Upload the video's thumbnail (if applicable) through the UploadVideoThumbnail stored procedure.
• Upload the video's captions (if applicable) through the UploadVideoCaptions stored procedure.

Below are some other restrictions for video assets:

1. The video's size can't exceed 5 GiB.
2. Only the MP4 format is supported.

Input

Name	Type	Required	Description
OwnerURN	String	True	The URN of the organization to use as the new video's owner.
LocalFile	String	False	The absolute path of the video file in your system to upload to LinkedIn.
FileStreamSize	Long	False	The size in bytes of the 'InputStream' object provided in the 'FileStream' parameter. This input is required if the 'FileStream' parameter was used.
FileData	String	False	A Base64-encoded string containing the data of the video to upload to LinkedIn. Useful in cases when neither the 'LocalFile' parameter nor the 'FileStream' parameter are viable options.
HasCaptions	Boolean	False	Boolean value indicating whether the new video will contain captions or not. If yes (true), the URL for uploading the captions will be returned in the results of the procedure. デフォルト値はfalseです。
HasThumbnail	Boolean	False	Boolean value indicating whether the new video will contain a thumbnail or not. If yes (true), the URL for uploading the thumbnail will be returned in the results of the procedure. デフォルト値はfalseです。

Result Set Columns

Name	Type	Description
VideoURN	String	The URN of the new video asset that was created, if the upload was successful.
CaptionsUploadURL	String	The URL to use for uploading the video's captions.
ThumbnailUploadURL	String	The URL to use for uploading the video's thumbnail.

Upload the captions of your video assets. Ony the '.srt' format is supported.

Procedure Specific Information

To use this stored procedure, exactly one of the following parameters must be specified (in addition to UploadURL):

• LocalFile
• FileStream
• FileData

If no parameter is used, or more than one parameter is used, the procedure will fail.

Input

Name	Type	Required	Description
UploadURL	String	True	The URL to use for uploading the video's captions.
LocalFile	String	False	The absolute path of the subtitle file in your system to upload for the video's captions.
FileData	String	False	A Base64-encoded string containing the subtitle data to upload for the video's captions. Useful in cases when neither the 'LocalFile' parameter nor the 'FileStream' parameter are viable options.

Result Set Columns

Name	Type	Description
Success	Boolean	A boolean value indicating whether the captions were uploaded successfully or not.

Upload the thumbnails of your video assets.

Procedure Specific Information

To use this stored procedure, exactly one of the following parameters must be specified (in addition to UploadURL):

• LocalFile
• FileStream
• FileData

If no parameter is used, or more than one parameter is used, the procedure will fail.

Input

Name	Type	Required	Description
UploadURL	String	True	The URL to use for uploading the video's thumbnail.
LocalFile	String	False	The absolute path of the image file in your system to upload for the video's thumbnail.
FileData	String	False	A Base64-encoded string containing the image data to upload for the video's thumbnail. Useful in cases when neither the 'LocalFile' parameter nor the 'FileStream' parameter are viable options.

Result Set Columns

Name	Type	Description
Success	Boolean	A boolean value indicating whether the thumbnail was uploaded successfully or not.

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

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

Authentication

---

プロパティ	説明
CompanyId	The company Id of the currently logged on user. If specifying the Company Id in the query, use the format urn:li:organization:{thecompanyid}.

OAuth

---

プロパティ	説明
OAuthClientId	カスタムOAuth アプリケーションに割り当てられたクライアントID（コンシューマーキーとも呼ばれます）を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。
OAuthClientSecret	カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタムOAuth アプリケーションのみ）
Scope	A specific scope that the user requires the access token.

SSL

---

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

Firewall

---

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

Proxy

---

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

Logging

---

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

Schema

---

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

Miscellaneous

---

プロパティ	説明
MaxRows	集計やGROUP BY を含まないクエリで返される最大行数を指定します。
Other	特定の問題に対処するため、特殊なシナリオ向けの高度な接続プロパティを指定します。このプロパティは、サポートチームの指示がある場合にのみ使用してください。
Pagesize	provider がLinkedIn にデータをリクエストするときに返す、ページあたりの最大レコード数を指定します。
PseudoColumns	テーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。
Timeout	provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。
UserDefinedViews	カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。

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

---

プロパティ	説明
CompanyId	The company Id of the currently logged on user. If specifying the Company Id in the query, use the format urn:li:organization:{thecompanyid}.

The company Id of the currently logged on user. If specifying the Company Id in the query, use the format urn:li:organization:{thecompanyid}.

解説

This property must be set in the connection string or query. Otherwise, the Sync App will use the first found company Id.

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

---

プロパティ	説明
OAuthClientId	カスタムOAuth アプリケーションに割り当てられたクライアントID（コンシューマーキーとも呼ばれます）を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。
OAuthClientSecret	カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタムOAuth アプリケーションのみ）
Scope	A specific scope that the user requires the access token.

カスタムOAuth アプリケーションに割り当てられたクライアントID（コンシューマーキーとも呼ばれます）を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。

解説

このプロパティは2つのケースで必要となります：

• カスタムOAuth アプリケーションを使用する場合。たとえば、Web ベースの認証フロー、サービスベースの認証、またはアプリケーションの登録が必要な証明書ベースのフローなどが該当します。
• ドライバーが埋め込みOAuth 資格情報を提供しない場合。

（ドライバーが埋め込みOAuth 資格情報を提供する場合、この値はすでにSync App によって設定されており、手動で入力する必要がないことがあります。）

OAuthClientId は、認証付きの接続を構成する際に、OAuthClientSecret やOAuthSettingsLocation などの他のOAuth 関連プロパティと一緒に使用されるのが一般的です。

OAuthClientId は、ユーザーがOAuth 経由で認証を行う前に設定する必要がある、主要な接続パラメータの1つです。 この値は、通常、ID プロバイダーのアプリケーション登録設定で確認できます。 Client ID、Application ID、Consumer Key などとラベル付けされた項目を探してください。

クライアントID は、クライアントシークレットのような機密情報とは見なされませんが、アプリケーションの識別情報の一部であるため、慎重に取り扱う必要があります。公開リポジトリや共有設定ファイルでこの値を露出させないようにしてください。

接続設定時にこのプロパティを使用する方法の詳細については、接続の確立 を参照してください。

カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタムOAuth アプリケーションのみ）

解説

このプロパティ（アプリケーションシークレットまたはコンシューマシークレットとも呼ばれます）は、安全なクライアント認証を必要とするすべてのフローでカスタムOAuth アプリケーションを使用する場合に必要です。たとえば、Web ベースのOAuth、サービスベースの接続、証明書ベースの認可フローなどが該当します。 組み込みOAuth アプリケーションを使用する場合は必要ありません。

クライアントシークレットは、OAuth フローのトークン交換ステップで使用されます。このステップでは、ドライバーが認可サーバーにアクセストークンを要求します。 この値が欠落しているか正しくない場合、認証はinvalid_client またはunauthorized_client エラーで失敗します。

OAuthClientSecret は、ユーザーがOAuth 経由で認証を行う前に設定する必要がある、主要な接続パラメータの1つです。この値は、OAuth アプリケーションを登録する際にID プロバイダーから取得できます。

Notes：

• この値は安全に保管し、公開リポジトリやスクリプト、安全でない環境では決して公開しないようにしてください。
• クライアントシークレットは、一定期間が経過すると有効期限が切れる場合もあります。 アクセスを中断させないために、有効期限を常に監視し、必要に応じてシークレットをローテーションするようにしてください。

接続設定時にこのプロパティを使用する方法の詳細については、接続の確立 を参照してください。

A specific scope that the user requires the access token.

解説

This property must be set in the connection string to get a scoped token with specific privileges.

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

---

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

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

解説

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

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

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

Note：'*' を使用してすべての証明書を受け入れるように指定することも可能ですが、セキュリティ上の懸念があるため推奨されません。

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

---

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

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

解説

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

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

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

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

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

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

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

解説

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

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

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

解説

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

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

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

解説

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

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

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

解説

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

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

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

---

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

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

解説

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

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

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

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

解説

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

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

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

解説

ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたProxyServer ポートを通じてのみHTTP トラフィックをルーティングします。

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

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

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

解説

サポートされる認証の種類：

• BASIC：Sync App はHTTP Basic 認証を行います。
• DIGEST：Sync App はHTTP ダイジェスト認証を行います。
• NTLM：Sync App はNTLM トークンを取得します。
• NEGOTIATE： Sync App は認証において有効なプロトコルに応じて、NTLM もしくはKerberos トークンを取得します。
• NONE：ProxyServer が認証を必要としないことを示します。

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

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

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

解説

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

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

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

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

ProxyUser 接続プロパティで指定されたユーザーのパスワードを指定します。

解説

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

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

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

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

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

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

解説

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

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

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

解説

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

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

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

---

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

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

解説

Sync App は、実行する各操作の詳細を Logfile 接続プロパティで指定されたログファイルに書き込みます。

ログに記録される各操作は、モジュールと呼ばれるカテゴリに分類されます。各モジュールには対応する短いコードがあり、個々の Sync App の操作がどのモジュールに属するかを示すラベルとして使用されます。

この接続プロパティにモジュールコードをセミコロン区切りのリストで設定すると、指定したモジュールに属する操作のみがログファイルに書き込まれます。この設定は今後のログ記録にのみ適用され、既存のログファイルの内容には影響しません。例: INFO;EXEC;SSL;META;

デフォルトでは、すべてのモジュールの操作がログに含まれます。

モジュールを明示的に除外するには、先頭に「-」を付けます。例: -HTTP

サブモジュールにフィルターを適用するには、<モジュール名>.<サブモジュール名> の構文で指定します。たとえば、次の値を設定すると、Sync App は HTTP モジュールに属するアクションのみをログに記録し、さらに HTTP モジュールの Res サブモジュールに属するアクションを除外します: HTTP;-HTTP.Res

Verbosity 接続プロパティによるログファイルのフィルタリングは、この接続プロパティによるフィルタリングよりも優先されます。そのため、Verbosity 接続プロパティで指定したレベルよりも高い詳細レベルの操作は、この接続プロパティで指定したモジュールに属していても、ログファイルには出力されません。

使用可能なモジュールとサブモジュールは次のとおりです。

モジュール名	モジュールの説明	サブモジュール
INFO	一般情報。接続文字列、製品バージョン（ビルド番号）、および初期接続メッセージが含まれます。	Connec — 接続の作成または破棄に関連する情報。 Messag — 接続、接続文字列、製品バージョンに関するメッセージの汎用ラベル。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。
EXEC	クエリ実行。ユーザーが記述した SQL クエリ、解析済み SQL クエリ、正規化済み SQL クエリの実行メッセージが含まれます。クエリおよびクエリページの成功/失敗メッセージもここに表示されます。	Messag — クエリ実行に関するメッセージ。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。 Normlz — クエリの正規化ステップ。クエリの正規化とは、ユーザーが送信したクエリを、最適なパフォーマンスで同じ結果を得られるように書き換える処理です。 Origin — ユーザーの元のクエリ（ユーザーが実行した正確で未変更の非正規化クエリ）を記録するメッセージに適用されるラベル。 Page — クエリのページングに関連するメッセージ。 Parsed — クエリの解析ステップ。解析とは、ユーザーが送信したクエリを、処理しやすい標準化された形式に変換するプロセスです。
HTTP	HTTP プロトコルメッセージ。HTTP リクエスト/レスポンス（POST メッセージを含む）、および Kerberos 関連のメッセージが含まれます。	KERB — Kerberos に関連する HTTP リクエスト。 Messag — HTTP プロトコルに関するメッセージ。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。 Unpack — サービス API から返された圧縮データを製品が解凍する際のメッセージに適用されるラベル。 Res — HTTP レスポンスを含むメッセージ。 Req — HTTP リクエストを含むメッセージ。
WSDL	WSDL/XSD ファイルの生成に関するメッセージ。	—
SSL	SSL 証明書メッセージ。	Certif — SSL 証明書に関するメッセージ。
AUTH	認証関連の失敗/成功メッセージ。	Messag — 認証に関するメッセージ。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。 OAuth — OAuth 認証に関連するメッセージ。 Krbros — Kerberos 関連の認証メッセージ。
SQL	SQL トランザクション、SQL 一括転送メッセージ、および SQL 結果セットメッセージが含まれます。	Bulk — 一括クエリ実行に関するメッセージ。 Cache — パフォーマンス向上のため、製品のキャッシュへの行データの読み書きに関連するメッセージ。 Messag — SQL トランザクションに関するメッセージ。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。 ResSet — クエリの結果セット。 Transc — 実行されたジョブ数やバックアップテーブルの処理に関する情報を含む、トランザクション処理に関連するメッセージ。
META	メタデータキャッシュとスキーマメッセージ。	Cache — パフォーマンス向上のため、製品のキャッシュ内のカラムおよびテーブル定義の読み取りと変更に関連するメッセージ。 Schema — サービススキーマからのメタデータの取得またはサービススキーマの変更に関連するメッセージ。 MemSto — インメモリメタデータキャッシュへの書き込みまたは読み取りに関連するメッセージ。 Storag — メモリ内ではなく、ディスクまたは外部データストアへのメタデータの保存に関連するメッセージ。
FUNC	SQL 関数の実行に関連する情報。	Errmsg — SQL 関数の実行に関連するエラーメッセージ。
TCP	TCP トランスポートレイヤーメッセージでの送受信生バイト。	Send — TCP プロトコル経由で送信された生データ。 Receiv — TCP プロトコル経由で受信した生データ。
FTP	File Transfer Protocol に関するメッセージ。	Info — FTP プロトコルでの通信に関連するステータスメッセージ。 Client — FTP 通信中に FTP クライアント（製品）が実行したアクションに関連するメッセージ。 Server — FTP 通信中に FTP サーバーが実行したアクションに関連するメッセージ。
SFTP	Secure File Transfer Protocol に関するメッセージ。	Info — SFTP プロトコルでの通信に関連するステータスメッセージ。 To_Server — SFTP 通信中に SFTP クライアント（製品）が実行したアクションに関連するメッセージ。 From_Server — SFTP 通信中に SFTP サーバーが実行したアクションに関連するメッセージ。
POP	Post Office Protocol 経由で転送されるデータに関するメッセージ。	Client — POP 通信中に POP クライアント（製品）が実行したアクションに関連するメッセージ。 Server — POP 通信中に POP サーバーが実行したアクションに関連するメッセージ。 Status — POP プロトコルでの通信に関連するステータスメッセージ。
SMTP	Simple Mail Transfer Protocol 経由で転送されるデータに関するメッセージ。	Client — SMTP 通信中に SMTP クライアント（製品）が実行したアクションに関連するメッセージ。 Server — SMTP 通信中に SMTP サーバーが実行したアクションに関連するメッセージ。 Status — SMTP プロトコルでの通信に関連するステータスメッセージ。
CORE	他のモジュールでカバーされていない、さまざまな製品内部操作に関連するメッセージ。	—
DEMN	SQL リモーティングに関連するメッセージ。	—
CLJB	一括データアップロード（クラウドジョブ）に関するメッセージ。	Commit — 一括データアップロードの送信。
SRCE	他のモジュールに属さない、製品が生成するその他のメッセージ。	—
TRANCE	低レベルの製品操作に関する高度なメッセージ。	—

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

---

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

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

解説

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

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

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

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

解説

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

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

解説

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

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

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

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

解説

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

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

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

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

---

プロパティ	説明
MaxRows	集計やGROUP BY を含まないクエリで返される最大行数を指定します。
Other	特定の問題に対処するため、特殊なシナリオ向けの高度な接続プロパティを指定します。このプロパティは、サポートチームの指示がある場合にのみ使用してください。
Pagesize	provider がLinkedIn にデータをリクエストするときに返す、ページあたりの最大レコード数を指定します。
PseudoColumns	テーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。
Timeout	provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。
UserDefinedViews	カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。

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

解説

このプロパティのデフォルト値である-1 は、クエリに明示的にLIMIT 句が含まれていない限り、行の制限が適用されないことを意味します。 （クエリにLIMIT 句が含まれている場合、クエリで指定された値がMaxRows 設定よりも優先されます。）

MaxRows を0より大きい整数に設定することで、クエリがデフォルトで過度に大きな結果セットを返さないようにします。

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

特定の問題に対処するため、特殊なシナリオ向けの高度な接続プロパティを指定します。このプロパティは、サポートチームの指示がある場合にのみ使用してください。

解説

このプロパティにより、シニアユーザーはサポートチームのアドバイスに基づいて、特定の状況に対応する隠しプロパティを設定できます。 これらの設定は通常のユースケースには必要ありませんが、特定の要件に対応したり、追加の機能を提供したりすることができます。 複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。

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

統合およびフォーマット

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

provider がLinkedIn にデータをリクエストするときに返す、ページあたりの最大レコード数を指定します。

解説

クエリを処理する際、LinkedIn でクエリされたデータすべてを一度にリクエストする代わりに、Sync App はクエリされたデータをページと呼ばれる部分ごとにリクエストすることができます。

この接続プロパティは、Sync App がページごとにリクエストする結果の最大数を決定します。

Note：大きなページサイズを設定すると全体的なクエリ実行時間が短縮される可能性がありますが、その場合、クエリ実行時にSync App がより多くのメモリを使用することになり、タイムアウトが発生するリスクがあります。

テーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。

解説

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

個々の擬似カラムを指定するには、以下の形式を使用します。

Table1=Column1;Table1=Column2;Table2=Column3

すべてのテーブルのすべての擬似カラムを含めるには、次を使用してください：

*=*

provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。

解説

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

タイムアウトはデフォルトで60秒に設定されています。タイムアウトを無効にするには、このプロパティを0に設定します。

タイムアウトを無効にすると、操作が成功するか、サーバー側のタイムアウト、ネットワークの中断、またはサーバーのリソース制限などの他の条件で失敗するまで無期限に実行されます。

Note： このプロパティは慎重に使用してください。長時間実行される操作がパフォーマンスを低下させたり、応答しなくなる可能性があるためです。

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

解説

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

次に例を示します。

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

このプロパティを使用して、1つのファイルに複数のビューを定義し、ファイルパスを指定できます。 次に例を示します。

UserDefinedViews=C:\Path\To\UserDefinedViews.json

UserDefinedViews でビューを指定すると、Sync App はそのビューだけを参照します。

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

LZMA from 7Zip LZMA SDK

LZMA SDK is placed in the public domain.

Anyone is free to copy, modify, publish, use, compile, sell, or distribute the original LZMA SDK code, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.

LZMA2 from XZ SDK

Version 1.9 and older are in the public domain.

Xamarin.Forms

Xamarin SDK

The MIT License (MIT)

Copyright (c) .NET Foundation Contributors

All rights reserved.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

NSIS 3.10

Copyright (C) 1999-2025 Contributors THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS COMMON PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.

1. DEFINITIONS

"Contribution" means:

a) in the case of the initial Contributor, the initial code and documentation distributed under this Agreement, and b) in the case of each subsequent Contributor:

i) changes to the Program, and

ii) additions to the Program;

where such changes and/or additions to the Program originate from and are distributed by that particular Contributor. A Contribution 'originates' from a Contributor if it was added to the Program by such Contributor itself or anyone acting on such Contributor's behalf. Contributions do not include additions to the Program which: (i) are separate modules of software distributed in conjunction with the Program under their own license agreement, and (ii) are not derivative works of the Program.

"Contributor" means any person or entity that distributes the Program.

"Licensed Patents " mean patent claims licensable by a Contributor which are necessarily infringed by the use or sale of its Contribution alone or when combined with the Program.

"Program" means the Contributions distributed in accordance with this Agreement.

"Recipient" means anyone who receives the Program under this Agreement, including all Contributors.

2. GRANT OF RIGHTS

a) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, distribute and sublicense the Contribution of such Contributor, if any, and such derivative works, in source code and object code form.

b) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free patent license under Licensed Patents to make, use, sell, offer to sell, import and otherwise transfer the Contribution of such Contributor, if any, in source code and object code form. This patent license shall apply to the combination of the Contribution and the Program if, at the time the Contribution is added by the Contributor, such addition of the Contribution causes such combination to be covered by the Licensed Patents. The patent license shall not apply to any other combinations which include the Contribution. No hardware per se is licensed hereunder.

c) Recipient understands that although each Contributor grants the licenses to its Contributions set forth herein, no assurances are provided by any Contributor that the Program does not infringe the patent or other intellectual property rights of any other entity. Each Contributor disclaims any liability to Recipient for claims brought by any other entity based on infringement of intellectual property rights or otherwise. As a condition to exercising the rights and licenses granted hereunder, each Recipient hereby assumes sole responsibility to secure any other intellectual property rights needed, if any. For example, if a third party patent license is required to allow Recipient to distribute the Program, it is Recipient's responsibility to acquire that license before distributing the Program.

d) Each Contributor represents that to its knowledge it has sufficient copyright rights in its Contribution, if any, to grant the copyright license set forth in this Agreement.

3. REQUIREMENTS

A Contributor may choose to distribute the Program in object code form under its own license agreement, provided that:

a) it complies with the terms and conditions of this Agreement; and

b) its license agreement:

i) effectively disclaims on behalf of all Contributors all warranties and conditions, express and implied, including warranties or conditions of title and non-infringement, and implied warranties or conditions of merchantability and fitness for a particular purpose;

ii) effectively excludes on behalf of all Contributors all liability for damages, including direct, indirect, special, incidental and consequential damages, such as lost profits;

iii) states that any provisions which differ from this Agreement are offered by that Contributor alone and not by any other party; and

iv) states that source code for the Program is available from such Contributor, and informs licensees how to obtain it in a reasonable manner on or through a medium customarily used for software exchange.

When the Program is made available in source code form:

a) it must be made available under this Agreement; and

b) a copy of this Agreement must be included with each copy of the Program.

Contributors may not remove or alter any copyright notices contained within the Program.

Each Contributor must identify itself as the originator of its Contribution, if any, in a manner that reasonably allows subsequent Recipients to identify the originator of the Contribution.

4. COMMERCIAL DISTRIBUTION

Commercial distributors of software may accept certain responsibilities with respect to end users, business partners and the like. While this license is intended to facilitate the commercial use of the Program, the Contributor who includes the Program in a commercial product offering should do so in a manner which does not create potential liability for other Contributors. Therefore, if a Contributor includes the Program in a commercial product offering, such Contributor ("Commercial Contributor") hereby agrees to defend and indemnify every other Contributor ("Indemnified Contributor") against any losses, damages and costs (collectively "Losses") arising from claims, lawsuits and other legal actions brought by a third party against the Indemnified Contributor to the extent caused by the acts or omissions of such Commercial Contributor in connection with its distribution of the Program in a commercial product offering. The obligations in this section do not apply to any claims or Losses relating to any actual or alleged intellectual property infringement. In order to qualify, an Indemnified Contributor must: a) promptly notify the Commercial Contributor in writing of such claim, and b) allow the Commercial Contributor to control, and cooperate with the Commercial Contributor in, the defense and any related settlement negotiations. The Indemnified Contributor may participate in any such claim at its own expense.

For example, a Contributor might include the Program in a commercial product offering, Product X. That Contributor is then a Commercial Contributor. If that Commercial Contributor then makes performance claims, or offers warranties related to Product X, those performance claims and warranties are such Commercial Contributor's responsibility alone. Under this section, the Commercial Contributor would have to defend claims against the other Contributors related to those performance claims and warranties, and if a court requires any other Contributor to pay any damages as a result, the Commercial Contributor must pay those damages.

5. NO WARRANTY

EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely responsible for determining the appropriateness of using and distributing the Program and assumes all risks associated with its exercise of rights under this Agreement, including but not limited to the risks and costs of program errors, compliance with applicable laws, damage to or loss of data, programs or equipment, and unavailability or interruption of operations.

6. DISCLAIMER OF LIABILITY

EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

7. GENERAL

If any provision of this Agreement is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this Agreement, and without further action by the parties hereto, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.

If Recipient institutes patent litigation against a Contributor with respect to a patent applicable to software (including a cross-claim or counterclaim in a lawsuit), then any patent licenses granted by that Contributor to such Recipient under this Agreement shall terminate as of the date such litigation is filed. In addition, if Recipient institutes patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Program itself (excluding combinations of the Program with other software or hardware) infringes such Recipient's patent(s), then such Recipient's rights granted under Section 2(b) shall terminate as of the date such litigation is filed.

All Recipient's rights under this Agreement shall terminate if it fails to comply with any of the material terms or conditions of this Agreement and does not cure such failure in a reasonable period of time after becoming aware of such noncompliance. If all Recipient's rights under this Agreement terminate, Recipient agrees to cease use and distribution of the Program as soon as reasonably practicable. However, Recipient's obligations under this Agreement and any licenses granted by Recipient relating to the Program shall continue and survive.

Everyone is permitted to copy and distribute copies of this Agreement, but in order to avoid inconsistency the Agreement is copyrighted and may only be modified in the following manner. The Agreement Steward reserves the right to publish new versions (including revisions) of this Agreement from time to time. No one other than the Agreement Steward has the right to modify this Agreement. IBM is the initial Agreement Steward. IBM may assign the responsibility to serve as the Agreement Steward to a suitable separate entity. Each new version of the Agreement will be given a distinguishing version number. The Program (including Contributions) may always be distributed subject to the version of the Agreement under which it was received. In addition, after a new version of the Agreement is published, Contributor may elect to distribute the Program (including its Contributions) under the new version. Except as expressly stated in Sections 2(a) and 2(b) above, Recipient receives no rights or licenses to the intellectual property of any Contributor under this Agreement, whether expressly, by implication, estoppel or otherwise. All rights in the Program not expressly granted under this Agreement are reserved.

This Agreement is governed by the laws of the State of New York and the intellectual property laws of the United States of America. No party to this Agreement will bring a legal action under this Agreement more than one year after the cause of action arose. Each party waives its rights to a jury trial in any resulting litigation.