CData Sync App は、Slack データをデータベース、データレイク、またはデータウェアハウスに継続的にパイプライン化する簡単な方法を提供し、分析、レポート、AI、および機械学習で簡単に利用できるようにします。
Slack コネクタはCData Sync アプリケーションから使用可能で、Slack からデータを取得して、サポートされている任意の同期先に移動できます。
Sync App アプリケーションの接続 ページに移動し、接続の追加 パネルで対応するアイコンを選択して、Slack への接続を作成します。Slack アイコンが利用できない場合は、Add More アイコンをクリックしてCData サイトからSlack コネクタをダウンロードおよびインストールします。
必須プロパティは[設定]タブにリストされています。[Advanced]タブには、通常は必要ない接続プロパティが表示されます。
Slack はOAuth 認証標準を利用しています。OAuth を使って認証するには、アプリケーションを作成してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得する必要があります。OAuth 認証の使用 を参照してください。
このセクションでは、Slack Sync App の高度な機能を厳選して説明します。
Sync App を使用すると、事前設定されたクエリによって内容が決定されるユーザー定義ビューと呼ばれる仮想テーブルを定義できます。 このビューは、ドライバーに発行されるクエリを直接制御できない場合に有効です。 カスタムビューの作成と設定の概要については、ユーザー定義ビュー を参照してください。
SSL の設定 を使用して、Sync App が証明書のネゴシエーションをどのように扱うかを調整します。さまざまな証明書形式を選択できます。 詳しくは、接続文字列オプションにあるSSLServerCert プロパティを参照してください。
Windows プロキシとHTTP プロキシを含むファイアウォールとプロキシ に合致するようSync App を設定します。トンネル接続を設定することもできます。
Sync App は、Slack にできるだけ多くのSELECT ステートメント処理をオフロードし、残りのクエリをクライアント側のインメモリで処理します。
詳しくはクエリ処理 を参照してください。
CData ログを調整するために使用可能な設定の概要については、ログ を参照してください。基本的なロギングでは、 次の2つの接続プロパティを設定するだけです。LogModules 接続プロパティを使用してログに記録する情報のサブセットを選択できる、 より洗練されたロギングをサポートする多数の機能があります。
デフォルトでは、Sync App はサーバーの証明書をシステムの信頼できる証明書ストアと照合してSSL / TLS のネゴシエーションを試みます。
別の証明書を指定するには、利用可能なフォーマットについてSSLServerCert プロパティを参照してください。
Windows のシステムプロキシ経由の接続では、接続プロパティを追加で設定する必要はありません。他のプロキシに接続するには、ProxyAutoDetect をfalse に設定します。
さらにHTTP プロキシへの認証には、ProxyServer とProxyPort に加えてProxyAuthScheme、ProxyUser、およびProxyPassword を設定します。
次のプロパティを設定します。
Sync App は、Slack API をテーブル およびストアドプロシージャ としてモデル化します。
ストアドプロシージャはSlack のファンクションライクなインターフェースで、Slack API の他の側面を扱うことを可能にします。ストアドプロシージャを使用すると、Slack 内の情報を検索、更新、および編集できます。
テーブルとストアドプロシージャは、静的なスキーマファイルで定義されているため、カスタマイズが容易です。
Sync App はSlack のデータを、標準のSQL ステートメントを使用してクエリできるテーブルのリストにモデル化します。
一般的には、Slack テーブルのクエリは、リレーショナルデータベースのテーブルのクエリと同じです。時には特別なケースもあります。例えば、テーブルの特定のカラムデータを取得するために特定のカラムをWHERE 句に含める必要がある場合などです。これは通常、特定のカラムを取得するために行ごとに個別のリクエストを行う必要がある場合に必要です。これらの特別な状況は、以下にリンクされているテーブルページの上部に明確に文書化されています。
Name | Description |
Calls | Register,update,end or return information about a Call. |
Channels | Create, update, and query the available channels in Slack. |
Files | Query and delete team files. |
MessageReplies | Create, update, delete, and query threads of messages posted to a conversation. |
Messages | Create, update, delete, and query the available messages in Slack. |
Pins | Create, delete, and query all items pinned to a channel. |
Reactions | Create, delete, and query reactions on items. |
Reminders | Create, delete, and query all reminders by or for a given user. |
Stars | Create,List or Delete a user's saved items. |
UserGroups | Create, update, and query all User Groups for a Slack team. |
Users | Update and query all users for a Slack team. |
Register,update,end or return information about a Call.
You must specify the Id column in the WHERE clause to query the Calls table.
The Sync App will use the Slack API to process search criteria that refer to the Id column. This column supports server-side processing for the = operator. The Sync App processes other filters client-side within the Sync App.
For example, the following query is processed server side:
SELECT * FROM Calls WHERE Id='R04HH525YBS'
Inserts are allowed when you specify the ExternalUniqueId and JoinURL. For example:
INSERT INTO Calls(ExternalUniqueId, JoinURL) VALUES(uniqId, joinurl)
Updates are allowed when you specify the Id.
UPDATE Calls SET JoinURL='join', Title='t' WHERE Id='R04HH525YBS'
You can delete a pin by providing the Id.
DELETE FROM Calls WHERE id='R04HH525YBS'
Name | Type | ReadOnly | Description |
Id [KEY] | String | True |
Id of the call. |
DateStart | Datetime | True |
Start time of the call. |
DesktopAppJoinURL | String | False |
The desktop app join url of the call. |
ExternalDisplayId | String | False |
The external display of the call. |
ExternalUniqueId | String | False |
The external unique Id of the call. |
JoinURL | String | False |
The joining url of the call. |
Title | String | False |
The title of the call. |
Users | String | True |
The users involved in the call. |
Create, update, and query the available channels in Slack.
The Sync App will use the Slack API to process search criteria that refer to the Id, IsArchived, IsPublic, IsGroup, IsDirectMessage, and IsMultipartyDirectMessage columns. These columns support server-side processing for the = operator. The Sync App processes other filters client-side within the Sync App.
For example, the following queries are processed server side by the Slack APIs:
SELECT * FROM Channels WHERE IsPublic = false AND IsGroup = false AND IsArchived = true SELECT * FROM Channels WHERE Id = 'D71R6CSR1'You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.
The Name column is the minimum requirement for an insert. Name and IsPublic are the only columns that can be set on an insert.
INSERT INTO Channels (Name, IsPublic) VALUES ('initialname', true)
The Channels table allows updates for columns Name, Purpose, and Topic when Id is specified.
UPDATE Channels SET Topic = 'A Topic Text', Purpose = 'A Purpose Text', Name = 'updatedname' WHERE Id = 'D71R6CSR1'
Slack does not allow Channels to be deleted.
Name | Type | ReadOnly | Description |
Id [KEY] | String | True |
The Id of the channel. |
Name | String | False |
The name of the channel. |
Topic | String | False |
Information about the channel topic. |
TopicCreator | String | True |
Creator of the channel topic. |
Purpose | String | False |
Information about the channel purpose. |
TotalMembers | Integer | True |
Number of members in the channel. |
Created | Datetime | True |
Channel creation datetime. |
Creator | String | True |
User ID of the member that created this channel. |
LastRead | Datetime | True |
The datetime for the last message the calling user has read in this channel. |
IsMember | Boolean | True |
Indicates the user or bot user or Slack app associated with the token making the API call is itself a member of the conversation. |
IsArchived | Boolean | True |
Indicates a conversation is archived. Frozen in time |
IsPublic | Boolean | False |
Indicates whether a conversation is a public channel. Everything said in a public channel can be read by anyone else belonging to a workspace. |
IsGroup | Boolean | True |
Indicates whether the channel is a private channel between a group of members. |
IsDirectMessage | Boolean | True |
Means the conversation is a direct message between two distinguished individuals or a user and a bot. |
IsMultipartyDirectMessage | Boolean | True |
Represents an unnamed private conversation between multiple users. |
IsGeneral | Boolean | True |
Means the channel is the workspace's 'general' discussion channel. |
Unlinked | Integer | True |
Number of times a link to the channel has been removed. |
NameNormalized | String | True |
Normalized name of the channel. |
IsShared | Boolean | True |
Means the conversation is in some way shared between multiple workspaces. |
IsExtShared | Boolean | True |
Represents this conversation as being part of a Shared Channel with a remote organization. |
IsOrgShared | Boolean | True |
Explains whether this shared channel is shared between Enterprise Grid workspaces within the same organization. |
IsPendingExtShared | Boolean | True |
It means the conversation is ready to become an IsExtShared channel but isn't quite ready yet and needs some kind of approval or sign off. |
PreviousNames | String | True |
A list of previous names this channel has had. |
Locale | String | True |
Locale of the channel. |
User | String | True | |
IsUserDeleted | Boolean | True | |
Priority | String | True |
Query and delete team files.
The Sync App will use the Slack API to filter by search criteria that refer to the Id, Created, UserId, Types, SpecificChannel, or SearchTerm columns. All columns support server-side processing for the = operator, and the Created column also supports server-side processing for the >, >=, <, <= operators.
The Sync App processes other search criteria client-side within the Sync App.
For example, the following queries are processed server side:
SELECT * FROM Files WHERE Created > '2017-01-01' AND UserId = 'U2345NDS' AND SpecificChannel = 'D71R6CSR1'
You can also filter files by querying the files' contents: Set the SearchTerm pseudocolumn in the criteria. All files containing the queried word will be retrieved. For example:
SELECT * FROM Files WHERE SearchTerm = 'text'You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.
Slack does not allow inserting new files.
Slack does not allow updating files.
Files can be deleted by providing the Id of the file.
DELETE FROM Files WHERE Id = 'F71R6DRR1'
Name | Type | ReadOnly | Description |
Id [KEY] | String | True |
The Id of the file. |
Name | String | True |
The name of the file. It may nbe null for unnamed files |
Title | String | True |
The title of the file. |
Created | Datetime | True |
Creation date of the file. |
UserId | String | True |
User ID of the member that created this file. |
Username | String | True |
Username of the file creator. |
InitialComment | String | True |
A comment from the file uploader, and will only be set when the uploader left a comment at the time of upload. |
Size | Integer | True |
The filesize in bytes. Snippets are limited to a maximum file size of 1 megabyte |
Filetype | String | True |
The type of the file. |
Mimetype | String | True |
Mime type of the file. |
PrettyType | String | True |
Human-readable version of the type. |
CommentsCount | Integer | True |
Number of comments made on the file. |
Mode | String | True |
A property that contains one of hosted, external, snippet or post. |
PublicChannelIds | String | True |
A list of channel IDs in which the file is currently shared. |
GroupIds | String | True |
A list of private groups IDs in which the file is currently shared. |
DirectMessageIds | String | True |
A list of instant message IDs in which the file is currently shared. |
Editable | Boolean | True |
Indicates that files are stored in editable mode. |
Permalink | String | True |
URL that points to a single page for the file containing details, comments and a download link. |
PermalinkPublic | String | True |
If the file is available to the public, this URL points to the public file itself. |
EditLink | String | True |
Present for posts and snippets. The page where the file can be edited |
UrlPrivate | String | True |
Points to a URL to the file contents. |
UrlPrivateDownload | String | True |
For editable-mode files, this parameter includes headers to force a browser download. |
Thumb480 | String | True |
Contains the URL of an 480x480 thumb. |
SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
Name | Type | Description |
SpecificChannel | String |
Filter files appearing in a specific channel, indicated by its ID. |
SearchTerm | String |
Filter by this column to retrieve all files that contain the word in the criteria. |
Types | String |
Filter files by type. Allowed values are all,spaces,snippets,images,gdocs,zips. Default value is all. 使用できる値は次のとおりです。all, spaces, snippets, images, gdocs, zips |
Create, update, delete, and query threads of messages posted to a conversation.
The MessageReplies table requires the ChannelId And ParentMessageId columns in the WHERE clause. Search criteria that refer to other columns are processed client-side within the Sync App.
For example, the following query is processed server side:
SELECT * FROM MessageReplies WHERE ChannelId = 'D71R6CSR1' AND ParentMessageId = '1234567890.123456'You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.
Slack allows inserts only when ChannelId, Text, and ParentMessageId are specified.
INSERT INTO MessageReplies (ChannelId, Text, ParentMessageId) VALUES ('D71R6CSR1', 'This is a message', '1234567890.123456')
The MessageReplies table allows updates only for the Text field. Specify ChannelId and Id.
UPDATE MessageReplies Set Text = 'Updated message' WHERE ChannelId = 'D71R6CSR1' AND Id = '1234567890.123456'
MessageReplies can be deleted by providing the ChannelId and the Id of the message.
DELETE FROM MessageReplies WHERE ChannelId = 'D71R6CSR1' AND Id = '1234567890.123456
Name | Type | ReadOnly | Description |
Id [KEY] | String | True |
Unique identifier for the messages. |
ChannelId [KEY] | String | False |
Conversation ID to fetch thread from. |
UserId | String | True |
User Id of the user who posted the reply. |
Text | String | False |
Reply message content. |
ParentMessageId [KEY] | String | False |
Unique identifier of a thread's parent message. |
ReplyCount | Integer | True |
The replies number for thread's parent message. |
Subscribed | Boolean | True |
Indicates if the user is subscribed to this channel. |
LastRead | Datetime | True |
The datetime for the last message the calling user has read in this channel. |
UnreadCount | Integer | True |
The number of members that have not read the parent message. |
Create, update, delete, and query the available messages in Slack.
The Messages table requires ChannelId or SearchTerm in the WHERE clause. The Sync App also uses the Slack API to process search criteria that refer to the Id column. The ChannelId, SearchTerm, and Id columns support server-side processing for the = operator. The Sync App processes other search criteria client-side within the Sync App.
SELECT * FROM Messages WHERE ChannelId = 'D71R6CSR1' SELECT * FROM Messages WHERE SearchTerm = 'text'You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.
Slack allows inserts only when ChannelId and Text are specified.
INSERT INTO Messages (ChannelId, Text) VALUES ('D71R6CSR1', 'This is a message')
The Messages table allows updates only for the Text field. Specify ChannelId and Id.
UPDATE Messages Set Text = 'Updated message' WHERE ChannelId = 'D71R6CSR1' AND Id = '1234567890.123456'
Messages can be deleted by providing the ChannelId and the Id of the message.
DELETE FROM Messages WHERE ChannelId = 'D71R6CSR1' AND Id = '1234567890.123456'
Name | Type | ReadOnly | Description |
Id [KEY] | String | True |
The Id of the message. |
ChannelId [KEY] | String | False |
The Id of the channel the message was posted to. |
UserId | String | True |
The Id of the user that posted the message. |
Text | String | False |
Text of the message. |
Type | String | True |
Type of the message. |
Item_type | String | True |
Item type of the message. |
Subtype | String | True |
Subtype of the message. |
Team | String | True |
Team of the message. |
Pinned_to | String | False |
Pinned details of the message. |
Pinned_info_Channel | String | True |
Id of the pinned channel of the message. |
Pinned_info_pinned_by | String | True |
Id of the pinned by message. |
Pinned_info_pinned_ts | String | True |
Id of the pinned message of the message. |
AttachmentsAggregate | String | True |
Attachments made to the message. |
Purpose | String | False |
Purpose of the message. |
BotId | String | True |
BotId of the message. |
BotLink | String | True |
BotLink of the message. |
Username | String | True |
UserName of the message. |
Reply_count | Integer | False |
Count of the replied channels to the message. |
Reply_users_count | Integer | False |
Count of the replied users to the message. |
Latest_reply | String | True |
Latest message reply of the message. |
Last_read | String | True |
Last read message. |
Reply_usersAggreagte | String | True |
Replied user details of the message. |
Subscribed | Boolean | True |
Subscribed status of the message. |
Topic | String | True |
Topic of the message. |
Old_name | String | False |
Old Name of the message. |
Name | String | False |
Name of the message. |
SearchTerm | String | True |
Filter by this column to retrieve all messages that contain the word in the criteria. |
Create, delete, and query all items pinned to a channel.
You must specify the ChannelId column in the WHERE clause to query the Pins table.
The Sync App will use the Slack API to process search criteria that refer to the ChannelId column. This column supports server-side processing for the = operator. The Sync App processes other filters client-side within the Sync App.
For example, the following query is processed server side:
SELECT * FROM Pins WHERE ChannelId = 'D71R6CSR1'You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.
INSERTS are allowed when you specify the ChannelId, Id, and Type. For example:
INSERT INTO Pins (ChannelId, Id, Type) VALUES ('D71R6CSR1', 'F71R6DRR1', 'file')
Slack does not support the update of pins.
You can delete a pin by providing the ChannelId, Id, and Type.
DELETE FROM Pins WHERE ChannelId = 'D71R6CSR1' AND Id = '1505287261.000226' AND Type = 'message'
Name | Type | ReadOnly | Description |
Id [KEY] | String | False |
The Id of the pinned item. |
Type [KEY] | String | False |
The type of the pinned item. 使用できる値は次のとおりです。message, file, file comment |
Created | Datetime | True |
A unique datetime representing when the item was pinned. |
ChannelId [KEY] | String | False |
Channel Id to get pinned items for. |
PinnedToChannelIds | String | True |
Comma separated list of channel ids the item is pinned to. |
CreatedBy | String | True |
The encoded user id of the user who pinned the item. |
Create, delete, and query reactions on items.
The Sync App will use the Slack API to process search criteria that refer to the Team,Users column. This column supports server-side processing for the = operator. The Sync App processes other filters client-side within the Sync App.
SELECT * FROM Reactions
SELECT * FROM Reactions WHERE Users='U046AV8HU3G'
SELECT * FROM Reactions WHERE Team='T046W75LRTK'
SELECT * FROM Reactions WHERE Team='T046W75LRTK' AND Users='U046AV8HU3G'
Inserts are allowed when you specify the ChannelId, Id, Name and Type. For example:
INSERT INTO Reactions(ChannelId,Id,Type,Name) VALUES('C04HBS2PS56','1672114112.994259','message', 'raised_hands')
Slack does not support the update of reactions.
You can delete a pin by providing the ChannelId, Id, Name and Type.
DELETE FROM Reactions WHERE Name='raised_hands' AND ChannelId='C04HBS2PS56' AND Id='1672114112.994259' AND type='message'
Name | Type | ReadOnly | Description |
Id | String | False |
The Id of the reacted item. |
ChannelId | String | False |
The ChanneldId where item is reacted |
Type | String | False |
The type of the reacted item. 使用できる値は次のとおりです。message, file, file comment |
Name | String | False |
The name of the reaction |
Count | String | True |
The count of reactions on that message |
Users | String | True |
The encoded user id of the user who reacted to the message. |
Team | String | True |
The name of the reaction |
Create, delete, and query all reminders by or for a given user.
The Sync App uses the Slack API to process search criteria that refer to the Id column while other filters are processed client-side within the Sync App. For example, the following query is processed server side:
SELECT * FROM Reminders WHERE Id = 'RT7U7LN6F'You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.
Inserts are allowed when you specify the Text and Time for the reminder. You can also add UserId. For example:
INSERT INTO Reminders (Text, Time, UserId) VALUES ('Remind me for coffee', '2017-01-01 10:00', 'U723764DF')
Slack does not support the update of reminders.
You can delete a reminder by providing the Id.
DELETE FROM Reminders WHERE Id = 'R71R6CSR1'
Name | Type | ReadOnly | Description |
Id [KEY] | String | True |
The Id of the reminder. |
Creator | String | True |
The Id of the user who created the reminder. |
UserId | String | False |
The Id of the user the reminder is set for. |
Text | String | False |
The content of the reminder. |
Recurring | Boolean | True |
Indicates if this reminder is to be repeated. |
Time | Datetime | False |
The datetime of the reminder. |
CompleteTimestamp | Datetime | True |
The datetime when the reminder was completed. |
Create,List or Delete a user's saved items.
The Sync App will use the Slack API to process search criteria that refer to the Team column. This column supports server-side processing for the = operator. The Sync App processes other filters client-side within the Sync App.
SELECT * FROM Stars
SELECT * FROM Stars WHERE Team='T046W75LRTK'
Inserts are allowed when you specify the ChannelId, Id and Type. For example:
INSERT INTO Stars(ChannelId, Id, Type) VALUES('C046W75NBHP', '1666336493.256699', 'message'))
Slack does not support the update of reactions.
You can delete a pin by providing the ChannelId, Id and Type.
DELETE FROM Stars WHERE ChannelId='C046W75NBHP' AND Id='1666336493.25/6699' AND Type='message'
Name | Type | ReadOnly | Description |
Id [KEY] | String | False |
The Id of the starred item. |
ChannelId | String | False |
The ChannelId where the item is starred |
Type [KEY] | String | False |
The type of the starred item. 使用できる値は次のとおりです。message, file, file comment |
Team | String | True |
The encoded team id of the user who saved the message. |
User | String | True |
The encoded user id of the user who saved the message. |
CreatedAt | Datetime | True |
The timestamp of item saved |
Create, update, and query all User Groups for a Slack team.
The Sync App uses the Slack API to process search criteria that refer to the IncludeDisabled column while other search criteria are processed client-side within the Sync App. For example, the following query is processed server side:
SELECT * FROM UserGroups WHERE IncludeDisabled = 'true'
Inserts are allowed only for paid workspaces and when you specify the Name of the user group. Other optional fields are Description, Handle, and PreferredChannelIds. For example:
INSERT INTO UserGroups (Name, PreferredChannelIds) VALUES ('newgroup', 'C5S8LAY0Y,C79J7PREU')
You can update a user group by providing the Id and you can update the UserIds, Name, Description, PreferredChannelIds, and Handle columns. Updates are only allowed for paid workspaces.
UPDATE UserGroups SET PreferredChannelIds = 'C5S8LAY0Y,C79J7PREU', Name = 'newname' WHERE Id = 'U4826PEF'
Slack does not support the deletion of user groups.
Name | Type | ReadOnly | Description |
Id [KEY] | String | True |
The Id of the User Group. |
Name | String | False |
Indicates the friendly name of the group. |
Description | String | False |
Explains the purpose of the group. |
TeamId | String | True |
Identifier of the team this user group belongs to. |
UserIds | String | False |
Contains a list of user id values that belong to the User Group. |
UserCount | String | True |
Indicates the total number of users in a group. |
Handle | String | False |
Indicates the value used to notify group members via a mention without a leading @ sign. |
PreferredChannelIds | String | False |
Channels that members of this group will be invited to upon joining. |
PreferredGroupsIds | String | True |
Groups (private channels) that members of this group will be invited to upon joining. |
IsExternal | Boolean | True |
Represents this conversation as being externally shared. |
DateCreated | Datetime | True |
Datetime of the creation of the user group. |
DateUpdated | Datetime | True |
Datetime that the user group became disabled. |
CreatedBy | String | True |
Id of the user who created the user group. |
UpdatedBy | String | True |
Id of the user who last modified the user group. |
DeletedBy | String | True |
Id of the user who disabled/archived the user group. |
AutoType | String | True |
This parameter's value can be admins for a Workspace Admins group, owners for a Workspace Owners group or null for a custom group. |
SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
Name | Type | Description |
IncludeDisabled | Boolean |
A boolean set to include or exclude disabled User Groups in the retrieved data. |
Update and query all users for a Slack team.
The Sync App uses the Slack API to process search criteria that refer to the Id column, while other filters are processed client-side within the Sync App. For example, the following query is processed server side:
SELECT * FROM Users WHERE Id = 'U5SU7GU6N'
Slack does not support inserting new users.
You can update a user's FirstName, LastName, ProfileDisplayName, and ProfileEmail by providing the Id of the user. Only a team admin of a paid team can update another user's profile.
UPDATE Users Set ProfileDisplayName = 'Dis Name', ProfileEmail = '[email protected]' WHERE Id = 'U5SU7GU6N'
Slack does not support deleting users.
Name | Type | ReadOnly | Description |
Id [KEY] | String | True |
The Id of the User. |
FirstName | String | False |
Fist name of the user. |
LastName | String | False |
Last name of the user. |
FullName | String | True |
Full name of the user. |
ProfileDisplayName | String | False |
Display name of the user. |
ProfileEmail | String | False |
Email of the user. |
ProfileImage | String | True |
URLs to square, web-viewable image of a user's profile. |
Deleted | Boolean | True |
Indicates if the user is deactivated. |
TeamId | String | True |
Id of the Slack team the user belongs to. |
IsAdmin | Boolean | True |
Indicates whether the user administers this team. |
Color | String | True |
A field used in some clients to display a colored username. |
Timezone | String | True |
String for the geographic region. |
TimezoneLabel | String | True |
String describing the name of that timezone. |
TimezoneOffset | Integer | True |
A signed integer indicating the number of seconds to offset UTC time by. |
IsOwner | Boolean | True |
Indicates whether this user is the owner of this team. |
IsPrimaryOwner | Boolean | True |
Indicates whether this user is the primary owner of this team. |
IsRestricted | Boolean | True |
Indicates whether this user is restricted from the team . |
IsUltraRestricted | Boolean | True |
Indicates whether this user is forbidden from the team. |
Updated | Datetime | True |
A datetime that shows when the user was last updated. |
IsAppUser | Boolean | True |
A boolean value indicating if the user uses the Slack App. |
Has2fa | Boolean | True |
A boolean value indicating if the user uses Two Factor Authentication. |
プロパティ | 説明 |
OAuthVersion | The type of authentication to use when connecting to Slack. |
プロパティ | 説明 |
OAuthClientId | OAuth 認証サーバーを使用してアプリケーションを登録する場合に割り当てられたクライアントId。 |
OAuthClientSecret | OAuth 認証サーバーにアプリケーションを登録する場合に割り当てられたクライアントシークレット。 |
プロパティ | 説明 |
SSLServerCert | TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。 |
プロパティ | 説明 |
FirewallType | プロキシベースのファイアウォールで使われるプロトコル。 |
FirewallServer | プロキシベースのファイアウォールの名前もしくはIP アドレス。 |
FirewallPort | プロキシベースのファイアウォールのTCP ポート。 |
FirewallUser | プロキシベースのファイアウォールに認証するために使うユーザー名。 |
FirewallPassword | プロキシベースのファイアウォールへの認証に使われるパスワード。 |
プロパティ | 説明 |
ProxyAutoDetect | これは、システムプロキシ設定を使用するかどうかを示します。これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するにはProxyAutoDetect をFALSE に設定する必要があります。 |
ProxyServer | HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。 |
ProxyPort | ProxyServer プロキシが起動しているTCP ポート。 |
ProxyAuthScheme | ProxyServer プロキシへの認証で使われる認証タイプ。 |
ProxyUser | ProxyServer プロキシへの認証に使われるユーザー名。 |
ProxyPassword | ProxyServer プロキシへの認証に使われるパスワード。 |
ProxySSLType | ProxyServer プロキシへの接続時に使用するSSL タイプ。 |
ProxyExceptions | ProxyServer 経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。 |
プロパティ | 説明 |
LogModules | ログファイルに含めるコアモジュール。 |
プロパティ | 説明 |
Location | テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。 |
BrowsableSchemas | このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
Tables | このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。 |
Views | 使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。 |
プロパティ | 説明 |
MaxRows | クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。 |
Other | これらの隠しプロパティは特定のユースケースでのみ使用されます。 |
PseudoColumns | このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。 |
Team | The name of the Slack Team. If you omit the optional Team parameter, you will be allowed to choose which workspace they are authenticating against. |
Timeout | タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。 |
UserDefinedViews | カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。 |
このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。
プロパティ | 説明 |
OAuthVersion | The type of authentication to use when connecting to Slack. |
The type of authentication to use when connecting to Slack.
このセクションでは、本プロバイダーの接続文字列で設定可能なOAuth プロパティの全リストを提供します。
プロパティ | 説明 |
OAuthClientId | OAuth 認証サーバーを使用してアプリケーションを登録する場合に割り当てられたクライアントId。 |
OAuthClientSecret | OAuth 認証サーバーにアプリケーションを登録する場合に割り当てられたクライアントシークレット。 |
OAuth 認証サーバーを使用してアプリケーションを登録する場合に割り当てられたクライアントId。
OAuth アプリケーションの登録の一環として、コンシューマキーとも呼ばれるOAuthClientId 値、およびクライアントシークレットOAuthClientSecret が提供されます。
OAuth 認証サーバーにアプリケーションを登録する場合に割り当てられたクライアントシークレット。
OAuth アプリケーションの登録の一環として、コンシューマキーとも呼ばれるOAuthClientId が提供されます。また、コンシューマーシークレットと呼ばれるクライアントシークレットも提供されます。クライアントシークレットをOAuthClientSecret プロパティに設定します。
このセクションでは、本プロバイダーの接続文字列で設定可能な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 |
これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。
すべての証明書の受け入れを示すには、'*'を使用します。セキュリティ上の理由から、これはお勧めできません。
このセクションでは、本プロバイダーの接続文字列で設定可能なFirewall プロパティの全リストを提供します。
プロパティ | 説明 |
FirewallType | プロキシベースのファイアウォールで使われるプロトコル。 |
FirewallServer | プロキシベースのファイアウォールの名前もしくはIP アドレス。 |
FirewallPort | プロキシベースのファイアウォールのTCP ポート。 |
FirewallUser | プロキシベースのファイアウォールに認証するために使うユーザー名。 |
FirewallPassword | プロキシベースのファイアウォールへの認証に使われるパスワード。 |
プロキシベースのファイアウォールで使われるプロトコル。
このプロパティは、Sync App がFirewallServer プロキシ経由でトンネルトラフィックを使うためのプロトコルを指定します。デフォルトでは、Sync App はシステムプロキシに接続します。この動作を無効化し次のプロキシタイプのどれかで接続するには、ProxyAutoDetect をfalse に設定します。
タイプ | デフォルトポート | 説明 |
TUNNEL | 80 | これが設定されている場合、Sync App はSlack への接続を開き、プロキシを経由して通信が行われます。 |
SOCKS4 | 1080 | これが設定されている場合、Sync App はデータをFirewallServer およびFirewallPort で指定されたSOCS 4 プロキシ経由で送信し、接続リクエストが許容されるかどうかを決定します。 |
SOCKS5 | 1080 | これが設定されている場合、Sync App はデータをFirewallServer およびFirewallPort で指定されたSOCS 5 プロキシ経由で送信します。プロキシに認証が必要な場合には、FirewallUser およびFirewallPassword をプロキシが認識する認証情報に設定します。 |
HTTP プロキシへの接続には、ProxyServer およびProxyPort ポートを使ってください。HTTP プロキシへの認証には、ProxyAuthScheme、ProxyUser、およびProxyPassword を使ってください。
プロキシベースのファイアウォールの名前もしくはIP アドレス。
ファイアウォールトラバーサルを許容するために設定するIP アドレス、DNS 名、もしくはプロキシホスト名を指定するプロパティです。プロトコルはFirewallType で指定されます。このプロパティとFirewallServer を使って、SOCKS 経由での接続、もしくはトンネリングが可能です。HTTP プロキシへの接続には、ProxyServer を使用します。
Sync App はデフォルトでシステムプロキシを使うので注意してください。他のプロキシを使う場合には、ProxyAutoDetect をfalse に設定してください。
プロキシベースのファイアウォールのTCP ポート。
ファイアウォールトラバーサルを許容するために設定するプロキシベースのファイアウォールのTCP ポート。名前もしくはIP アドレスを指定するには、FirewallServer を使います。FirewallType でプロトコルを指定します。
プロキシベースのファイアウォールに認証するために使うユーザー名。
FirewallUser およびFirewallPassword プロパティは、FirewallType により指定された認証方式に則り、FirewallServer、およびFirewallPort で指定されたプロキシに対しての認証に使われます。
プロキシベースのファイアウォールへの認証に使われるパスワード。
このプロパティは、FirewallType により指定された認証メソッドに則り、FirewallServer およびFirewallPort で指定されたプロキシに渡されます。
このセクションでは、本プロバイダーの接続文字列で設定可能なProxy プロパティの全リストを提供します。
プロパティ | 説明 |
ProxyAutoDetect | これは、システムプロキシ設定を使用するかどうかを示します。これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するにはProxyAutoDetect をFALSE に設定する必要があります。 |
ProxyServer | HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。 |
ProxyPort | ProxyServer プロキシが起動しているTCP ポート。 |
ProxyAuthScheme | ProxyServer プロキシへの認証で使われる認証タイプ。 |
ProxyUser | ProxyServer プロキシへの認証に使われるユーザー名。 |
ProxyPassword | ProxyServer プロキシへの認証に使われるパスワード。 |
ProxySSLType | ProxyServer プロキシへの接続時に使用するSSL タイプ。 |
ProxyExceptions | ProxyServer 経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。 |
これは、システムプロキシ設定を使用するかどうかを示します。これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するにはProxyAutoDetect をFALSE に設定する必要があります。
これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するにはProxyAutoDetect をFALSE に設定する必要があります。
HTTP プロキシへの接続には、ProxyServer を参照してください。SOCKS やトンネリングなどの他のプロキシには、FirewallType を参照してください。
HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。
HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。HTTP プロキシへの認証には、Sync App はHTTP、Windows(NTLM)、もしくはKerberos 認証タイプを使用することができます。
SOCKS プロキシを経由して接続する、もしくは接続をトンネルするには、FirewallType を参照してください。
デフォルトで、Sync App はsystem プロキシを使います。他のプロキシを使う場合には、ProxyAutoDetect をfalse に設定します。
ProxyServer プロキシが起動しているTCP ポート。
HTTP トラフィックをリダイレクトするHTTP プロキシが実行されているポート。ProxyServer でHTTP プロキシを指定します。その他のプロキシタイプについては、FirewallType を参照してください。
ProxyServer プロキシへの認証で使われる認証タイプ。
この値は、ProxyServer およびProxyPort で指定されるHTTP プロキシに認証するために使われる認証タイプを指定します。
Sync App は、デフォルトでsystem proxy settings を使い、追加での設定が不要です。他のプロキシへの接続をする場合には、ProxyServer およびProxyPort に加え、ProxyAutoDetect をfalse に設定します。認証するには、ProxyAuthScheme を設定し、必要な場合にはProxyUser およびProxyPassword を設定します。
認証タイプは、次のどれかになります。
SOCKS 5 認証のような他の認証タイプを使用するには、FirewallType を参照してください。
ProxyServer プロキシへの認証に使われるユーザー名。
ProxyUser および ProxyPassword オプションは、ProxyServer で指定されたHTTP プロキシに対して接続および認証するために使用されます。
ProxyAuthScheme で使用可能な認証タイプを選択することができます。HTTP 認証を使う場合、これをHTTP プロキシで識別可能なユーザーのユーザー名に設定します。Windows もしくはKerberos 認証を使用する場合、このプロパティを次の形式のどれかでユーザー名に設定します。
user@domain domain\user
ProxyServer プロキシへの認証に使われるパスワード。
このプロパティは、NTLM(Windows)、Kerberos、もしくはHTTP 認証をサポートするHTTP プロキシサーバーに認証するために使われます。HTTP プロキシを指定するためには、ProxyServer およびProxyPort を設定します。認証タイプを指定するためにはProxyAuthScheme を設定します。
HTTP 認証を使う場合、さらにHTTP プロキシにProxyUser およびProxyPassword を設定します。
NTLM 認証を使う場合、Windows パスワードにProxyUser およびProxyPassword を設定します。Kerberos 認証には、これらを入力する必要があります。
SOCKS 5 認証もしくは、トンネリングは、FirewallType を参照してください。
デフォルトで、Sync App はsystem プロキシを使います。他のプロキシに接続する場合には、これをfalse に設定します。
ProxyServer プロキシへの接続時に使用するSSL タイプ。
このプロパティは、ProxyServer で指定されたHTTP プロキシへの接続にSSL を使用するかどうかを決定します。この値は、AUTO、ALWAYS、NEVER、TUNNEL のいずれかです。有効な値は次のとおりです。
AUTO | デフォルト設定。URL がHTTPS URL の場合、Sync App は、TUNNEL オプションを使います。URL がHTTP URL の場合、コンポーネントはNEVER オプションを使います。 |
ALWAYS | 接続は、常にSSL 有効となります。 |
NEVER | 接続は、SSL 有効になりません。 |
TUNNEL | 接続は、トンネリングプロキシを経由します。プロキシサーバーがリモートホストへの接続を開き、プロキシを経由して通信が行われます。 |
ProxyServer 経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。
ProxyServer は、このプロパティで定義されたアドレスを除くすべてのアドレスに使用されます。セミコロンを使用してエントリを区切ります。
Sync App は、追加設定なしにデフォルトでシステムのプロキシ設定を使います。この接続のプロキシ例外を明示的に構成するには、ProxyAutoDetect をfalse に設定して、ProxyServer およびProxyPort を設定する必要があります。認証するには、ProxyAuthScheme を設定し、必要な場合にはProxyUser およびProxyPassword を設定します。
ログファイルに含めるコアモジュール。
指定された(';' で区切られた)モジュールのみがログファイルに含まれます。デフォルトではすべてのモジュールが含まれます。
概要はログ ページを参照してください。
このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。
プロパティ | 説明 |
Location | テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。 |
BrowsableSchemas | このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
Tables | このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。 |
Views | 使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。 |
テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。
Sync App のスキーマファイル(テーブルとビューの場合は.rsd ファイル、ストアドプロシージャの場合は.rsb ファイル)を含むディレクトリへのパス。このフォルダの場所は、実行ファイルの場所からの相対パスにすることができます。Location プロパティは、定義をカスタマイズしたり(例えば、カラム名を変更する、カラムを無視するなど)、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。
指定しない場合、デフォルトの場所は"%APPDATA%\\CData\\Slack Data Provider\\Schema" となり、%APPDATA% はユーザーのコンフィギュレーションディレクトリに設定されます:
このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
スキーマをデータベースからリストすると、負荷がかかる可能性があります。接続文字列でスキーマのリストを提供すると、 パフォーマンスが向上します。
このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。
テーブルを複数のデータベースからリストすると、負荷がかかる可能性があります。接続文字列でテーブルのリストを提供すると、Sync App のパフォーマンスが向上します。
このプロパティは、作業したいビューがすでにわかっていて、ビューが多すぎる場合に、ビューを自動的にリストする代わりに使用することもできます。
カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。
複数のスキーマまたはカタログを持つデータソースに接続する場合は、複数のカタログやスキーマに存在するテーブル間の曖昧さを避けるため、最後の例のように、このプロパティにテーブルの完全修飾名を指定する必要があることに注意してください。
使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。
ビューを複数のデータベースからリストすると、負荷がかかる可能性があります。接続文字列でビューのリストを提供すると、Sync App のパフォーマンスが向上します。
このプロパティは、作業したいビューがすでにわかっていて、ビューが多すぎる場合に、ビューを自動的にリストする代わりに使用することもできます。
カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。
複数のスキーマまたはカタログを持つデータソースに接続する場合は、複数のカタログやスキーマに存在するテーブル間の曖昧さを避けるため、最後の例のように、このプロパティにテーブルの完全修飾名を指定する必要があることに注意してください。
このセクションでは、本プロバイダーの接続文字列で設定可能なMiscellaneous プロパティの全リストを提供します。
プロパティ | 説明 |
MaxRows | クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。 |
Other | これらの隠しプロパティは特定のユースケースでのみ使用されます。 |
PseudoColumns | このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。 |
Team | The name of the Slack Team. If you omit the optional Team parameter, you will be allowed to choose which workspace they are authenticating against. |
Timeout | タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。 |
UserDefinedViews | カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。 |
クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。
クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。
これらの隠しプロパティは特定のユースケースでのみ使用されます。
以下にリストされているプロパティは、特定のユースケースで使用可能です。通常のドライバーのユースケースおよび機能では、これらのプロパティは必要ありません。
複数のプロパティをセミコロン区切りリストで指定します。
DefaultColumnSize | データソースがメタデータにカラムの長さを提供しない場合に、文字列フィールドのデフォルトの長さを設定します。デフォルト値は2000です。 |
ConvertDateTimeToGMT | 日時の値を、マシンのローカルタイムではなくGMT グリニッジ標準時に変換するかどうかを決定します。 |
RecordToFile=filename | 基底のソケットデータ転送を指定のファイルに記録します。 |
このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
Entity Framework ではテーブルカラムでない疑似カラムに値を設定できないため、この設定はEntity Framework で特に便利です。この接続設定の値は、"Table1=Column1, Table1=Column2, Table2=Column3" の形式です。"*=*" のように"*" 文字を使用して、すべてのテーブルとすべてのカラムを含めることができます。
The name of the Slack Team. If you omit the optional Team parameter, you will be allowed to choose which workspace they are authenticating against.
The name of the Slack Team. If you omit the optional Team parameter, you will be allowed to choose which workspace they are authenticating against.
タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
Timeout が0に設定されている場合は、操作がタイムアウトしません。処理が正常に完了するか、エラー状態になるまで実行されます。
Timeout の有効期限が切れても処理が完了していない場合は、Sync App は例外をスローします。
カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。
ユーザー定義ビューは、UserDefinedViews.json というJSON 形式のコンフィギュレーションファイルで定義されています。Sync App は、このファイルで指定されたビューを自動的に検出します。
また、複数のビュー定義を持ち、UserDefinedViews 接続プロパティを使用して制御することも可能です。このプロパティを使用すると、指定されたビューのみがSync App によって検知されます。
このユーザー定義ビューのコンフィギュレーションファイルは、次のようにフォーマットされています。
次に例を示します。
{ "MyView": { "query": "SELECT * FROM Channels WHERE MyColumn = 'value'" }, "MyView2": { "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)" } }UserDefinedViews 接続プロパティを使用して、JSON コンフィギュレーションファイルの場所を指定します。次に例を示します。
"UserDefinedViews", "C:\\Users\\yourusername\\Desktop\\tmp\\UserDefinedViews.json"