# 通过数据市场交换资源 数据市场交换是数据提供方将资源文件上架到数据市场，数据消费方通过数据市场查看和订阅资源，本文以个人数据为例介绍数据市场交换资源。 #### 使用流程 图1通过数据市场交换资源流程 ![](https://support.huaweicloud.com/qs-eds/zh-cn_image_0000001970450757.png "点击放大") 1. 数据提供方添加数据资源到EDS数据目录下，请参见[步骤1：新增资源]。 2. 将数据资源上架到数据市场，请参见[步骤2：上架offer]。 3. 数据提供方的审批人确认该申请无误，审批上架，请参见[步骤3：审批offer上架请求]。 4. 数据消费方在数据市场搜索所需offer，进行订阅获取数据资源，请参见[步骤4：订阅offer]。 5. 数据提供方审批人审批数据消费方订阅offer的申请，请参见[（可选）步骤5：审批订阅请求]。 6. 数据提供方审批人审批的Offer申请生成合约后进行合约审批，请参见[（可选）步骤6：审批合约]。 7. 数据消费方管理接收到的数据资源，请参见[步骤7：使用资源]。 #### 前提条件 - 用户购买或加入交换数据空间，具体操作请参见[购买/加入交换数据空间](https://support.huaweicloud.com/usermanual-eds/eds_03_0002.html)。 - 用户开通并购买/加入连接器，具体操作请参见[开通并购买/加入连接器](https://support.huaweicloud.com/usermanual-eds/eds_03_0067.html)。 - （可选）如果用户加入他人连接器，连接器管理员须授予用户对应角色的权限，具体操作请参见[角色管理](https://support.huaweicloud.com/usermanual-eds/eds_03_0026.html)。 #### 步骤1：新增资源 如下步骤由数据提供方进行操作。 1. 数据提供方进入[交换数据空间管理控制台](https://auth.huaweicloud.com/authui/login.html?service=https://console.huaweicloud.com/edsconsole/#/login)，单击"我的空间"，选择空间实例，单击实例卡片上的"连接器"。 2. 选择连接器，单击连接器卡片上的"前往"，进入连接器控制台界面。 3. 选择界面左侧导航栏中的"数据目录"，选择"我的数据 \> 本地接入"，单击"新增资源"。 4. 在"新增资源"界面中，定义资源，具体的参数说明如[表1]所示。 表1参数说明 | 参数 | 说明 | |:---|:---| | 资源类型 | - 文件：非结构化的数据资源，当前支持xlsx、pdf、xls、ppt、pptx、doc、dot、docx、jpeg、jpg、png、gif、bmp、ftp、obs等类型文件。 - 数据集：结构化的数据资源，当前支持上传CSV、API、DB格式的数据文件。 | | 资源数量 | - 定义为一个资源：将上传的一个或多个文件定义为一个资源，在数据交换等操作时根据此资源名称交换该资源名称下的所有文件，需要填写资源名称。 - 定义为多个资源：将上传的每个文件都单独作为一个资源，并且把文件名称作为资源名称，无需单独命名。 定义为多个资源只适用于资源类型选择为文件类型。 | | 资源名称 | 文件上传后在数据目录展示的名称。 要求如下： - 长度范围为2\~200个字符。 - 只能包含中文，英文字母，数字，下划线，中划线、中英文括号。 | | 资源描述 | 对资源的描述说明。 | 5. 定义资源后，添加资源数据。 - 资源类型为文件时，数据来源支持选择浏览器上传、FTP存储、SFTP存储、OBS存储。具体的参数说明如[表2]所示。 表2参数说明 | 参数 | 说明 | |:---|:---| | 浏览器上传 | 用户使用浏览器本地上传文件到EDS空间下的连接器。 单击"新增文件"，添加待上传的数据文件后，界面将显示文件的文件名称、类型、大小、操作等基本信息。 - 如上传的文件是Excel格式且文件中嵌入了图片，建议将文件打成压缩包上传。 - 浏览器上传的文件限制请单击"文件限制"查看限制文件类型、最大上传大小、是否支持在线查看、最大查看大小。 图2查看文件限制 ![](https://support.huaweicloud.com/qs-eds/zh-cn_image_0000002214509154.png "点击放大") | | FTP存储 | 通过上传FTP存储目录路径来获取该路径下的文件。 - 数据源 FTP数据源，用户从FTP数据库服务器获取数据。如没有FTP数据源，可通过[接入FTP数据源](https://support.huaweicloud.com/usermanual-eds/eds_03_0041.html)接入。 - 访问路径 FTP服务器中要访问的文件夹的路径。 通过FTP数据源获取的文件限制请单击"限制详情"，查看限制的资源大小以及限制详情。 图3查看限制详情 ![](https://support.huaweicloud.com/qs-eds/zh-cn_image_0000002214509390.png "点击放大") | | SFTP存储 | 通过上传SFTP存储目录路径来获取该路径下的文件。 - 数据源 FTP数据源，用户从FTP数据库服务器获取数据。如没有FTP数据源，可通过[接入SFTP数据源](https://support.huaweicloud.com/usermanual-eds/eds_03_02006.html)接入。 - 访问路径 SFTP服务器中要访问的文件夹的路径。 通过SFTP数据源获取的文件限制请单击"限制详情"，查看限制的资源大小以及限制详情。 图4查看限制详情 ![](https://support.huaweicloud.com/qs-eds/zh-cn_image_0000002249429605.png "点击放大") | | OBS存储 | 通过上传OBS存储目录路径来获取该路径下的文件。 - 数据源 OBS数据源，用户从OBS桶中获取数据。如没有OBS数据源，可通过[接入OBS数据源](https://support.huaweicloud.com/usermanual-eds/eds_03_0042.html)接入。 - 访问路径 OBS桶中存放文件的路径。 通过OBS数据源获取的文件限制请单击"限制详情"，查看限制的资源大小以及限制详情。 图5查看限制详情 ![](https://support.huaweicloud.com/qs-eds/zh-cn_image_0000002249594789.png "点击放大") | - 资源类型为数据集时，具体的参数说明如[表3]所示。 表3参数说明 | 数据源类型 | 参数 | 说明 | |:---|:---|:---| | CSV | 存储方式 | 文件存储方式，当前仅支持物理存储。 | | CSV | 文件 | 用户本地上传CSV文件到EDS空间下的连接器。 单击"上传文件"，添加待上传的数据文件后，界面将显示文件名称和大小，并展示预览CSV文件数据。 说明： CSV格式的文件表头不可为中文且不能重复。 | | API | 存储方式 | 文件存储方式，当前仅支持物理存储。 | | API | API名称 | 选择已经配置好的API。 | | API | API描述 | 对已选择的API添加描述说明。 | | API | 数据名称 | 配置数据名称。 | | API | 入参设置 | API的入参配置，其中"是否必填"以及"值"为用户自定义配置。 - 是否必填：入参参数是否为必填项，如为必填项，则开启。 - 值：支持修改值，对此字段配置过滤值。 | | API | 出参设置 | API的出参配置，其中"是否选择"以及"是否支持搜索"为用户自定义配置。 - 是否选择：可开启和关闭，表示该字段是否在列表中显示。 - 是否支持搜索：支持开启和关闭，如果关闭表示该字段不支持按条件查询。 | | DB | 存储方式 | 文件存储方式，当前仅支持物理存储。 | | DB | 数据源名称 | 用户可以选择DWS、MySQL、ORACLE或MRS_HIVE数据源，从数据库中获取数据。如没有数据源，可通过[接入数据源](https://support.huaweicloud.com/usermanual-eds/eds_03_0037.html)接入。 | | DB | 表名称 | 选择数据库中的表，可通过下拉框选择相应的表数据。 | | DB | 数据名称 | 配置数据名称。 | | DB | 数据设置 | 表示选择某个数据源的某张表后，展示该表的字段，选择所需要的字段，进行自定义配置。 - 选择：![](https://support.huaweicloud.com/qs-eds/zh-cn_image_0000001951562561.png "点击放大")表示选择此字段。 - 中文名称：字段的中文名称。 - 英文名称：字段的英文名称。 - 过滤：表示是否对此字段进行过滤，![](https://support.huaweicloud.com/qs-eds/zh-cn_image_0000001924443486.png "点击放大")表示开启过滤。 - 过滤类型：可选择过滤类型（=、\>、\>=、\<、\<=、between、like、in），对数据记录进行过滤。 - 过滤值： - 过滤类型为"="时，过滤值自定义输入。 - 过滤类型为"\>"时，过滤筛选出来的内容需大于配置的过滤值。 - 过滤类型为"\>="时，过滤筛选出来的内容需大于等于配置的过滤值。 - 过滤类型为"\<"时，过滤筛选出来的内容需小于配置的过滤值。 - 过滤类型为"\<="时，过滤筛选出来的内容需小于等于配置的过滤值。 - 过滤类型为"between"时，需输入起始值以及终止值，过滤筛选出来的内容为起始值以及终止值的中间值。 - 过滤类型为"like"时，输入关键字，用于进行模糊筛选，表示过滤筛选出来的内容包含输入的过滤值中的关键字。 - 过滤类型为"in"时，直接输入，若为多个值用英文逗号隔开，表示过滤筛选出来的内容为输入的过滤值中的其中一个。 | | DB | 增量方式 | 系统默认选择为"全量"。 | 6. （可选）如果您选择的资源类型为数据集且资源数据为API或DB时，可选择是否定时采集数据，具体的参数说明如[表4]所示。 表4参数说明 | 参数 | 说明 | |:---|:---| | 是否定时采集 | 选择是否要开启定时采集任务。 | | 定时调度 | 选择采集任务执行的定时调度类型，与定时执行时间配合使用。 | | 定时执行时间 | 选择采集任务定时执行时间。 | | 定时说明 | 对选择的定时调度和定时执行时间进行解释说明。 | 7. 数据添加完成后，单击"提交"，提交上传的数据资源。 如勾选"本次提交执行调度（调度结果可在资源日志中查看）"则会在提交时立即执行一次采集任务。 #### 步骤2：上架offer 如下步骤由数据提供方进行操作。 1. 数据提供方进入[交换数据空间管理控制台](https://auth.huaweicloud.com/authui/login.html?service=https://console.huaweicloud.com/edsconsole/#/login)，单击"我的空间"，选择空间实例，单击实例卡片上的"连接器"。 2. 选择连接器，单击连接器卡片上的"前往"，进入连接器控制台界面。 3. 选择界面左侧导航栏中的"数据目录"，选择"我的数据 \> 本地接入"。 4. 勾选资源，然后单击资源列表上方"上架offer"。 5. 在"上架offer"界面填写基本信息，具体参数说明如[表5]所示。 表5参数说明 | 参数 | 说明 | |:---|:---| | 可见范围 | - 完全公开：即该交换数据空间下的所有连接器都可以看到此offer。 - 连接器分组公开：即该连接器分组中的连接器可以看到此offer。 - 指定连接器公开：即指定的连接器可以看到此offer。连接器可选多个，最终offer的可见范围为所选连接器。 | | 订阅类型 | - 受控：用户在数据市场订阅需要提供方审批。 - 公开：用户在数据市场订阅无需提供方审批。 | | offer描述 | 填写offer的描述信息，非必填项。 | 6. 在"数据清单"区域检查数据清单内容是否正确。支持对数据列表内容进行添加、删除等操作。 - 添加：单击"选择连接器数据"，在弹出的"选择连接器资源"界面选择要上传的数据资源文件，单击"确定"，添加文件。 - 删除：单击对应数据资源文件右侧的"删除"，删除已选择的资源文件。 - 清空：单击资源列表上方的"清空"，清空已选择的所有资源文件。 - 详情：单击对应数据资源文件右侧的"详情"，查看数据详情。 offer联系人：选择需要上架offer的联系人信息，下拉框选项为已创建并授权交换数据空间服务的用户。 7. 编辑使用策略，相关参数说明如[表6]所示。 表6参数说明 | 策略 | 参数 | 说明 | |:---|:---|:---| | 数据使用策略 | 已选操作 | 数据提供方对数据消费方操作数据的限制方法，通过"约束条件"对查看、加工和下载进一步限制。 - 查看：用户可以查看资源文件详细信息。 - 加工：用户可以在查看的时候对数据资源文件加工处理。 - 下载：用户可以通过限制下载次数和限制可用应用将数据资源文件下载到应用所描述的地方。 用户根据需求勾选"查看"、"加工"、"下载"，给数据消费方指定使用规则。 | | 数据使用策略 | 约束条件 | 通过When、How to、How many三个方面限制数据消费方对数据的使用。 - When：控制使用的时间，包括起始时间和截止时间。 - How to：限制不同的应用使用。如果暂无可用应用，可前往[注册应用实例](https://support.huaweicloud.com/usermanual-eds/eds_03_0030.html)。 - How many：限制可用操作的次数，此处使用次数为每个文件"查看+加工+下载"总次数，不输入则默认不限制。 | 8. 选择审批人，即选择offer上架的审批对象。 ![](https://support.huaweicloud.com/qs-eds/public_sys-resources/note_3.0-zh-cn.png) 审批人选择自己时跳过审批环节，资源直接上架成功。当审批人选择其他用户时，需要走审批流程。 9. 选择完成后，单击"确定"，等待审批人审批后，完成上架offer。 #### 步骤3：审批offer上架请求 如下步骤由数据提供方的审批人进行操作。 ![](https://support.huaweicloud.com/qs-eds/public_sys-resources/note_3.0-zh-cn.png) 审批人判断资源交换、上架offer和形成合约信息无误，审批通过。可通过"连接器管理 \> 用户管理"，单击右侧"用户授权"，查看用户的角色。再通过"连接器管理 \> 角色管理"，查看用户的角色是否拥有审批权限。 1. 数据提供方进入[交换数据空间管理控制台](https://auth.huaweicloud.com/authui/login.html?service=https://console.huaweicloud.com/edsconsole/#/login)，单击"我的空间"，选择空间实例，单击实例卡片上的"连接器"。 2. 选择连接器，单击连接器卡片上的"前往"，进入连接器控制台界面。 3. 选择界面左侧导航栏中的"连接器管理 \> 申请待办"，进入"我的申请待办"界面。 4. 在界面下方选择"我的待办"页签，选择需要审批的"offer审批"任务，单击"操作"列的"审批"。 5. 在弹出"数据offer详情"界面中，确认offer的基本信息，确认无误后单击"通过"。 6. 在弹出的"审批"窗口中，填写"审批意见"，单击"确定"。 #### 步骤4：订阅offer 如下步骤由数据消费方进行操作。 1. 数据消费方进入[交换数据空间管理控制台](https://auth.huaweicloud.com/authui/login.html?service=https://console.huaweicloud.com/edsconsole/#/login)，单击"我的空间"，选择空间实例，单击实例卡片上的"连接器"。 2. 选择连接器，单击连接器卡片上的"前往"，进入连接器控制台界面。 3. 选择界面左侧导航栏中的"数据市场"，在搜索框中输入需要查询的offer关键字，单击![](https://support.huaweicloud.com/qs-eds/zh-cn_image_0000001972820518.png)跳转到数据offer列表界面。 4. 用户可通过筛选"热度"来获得最近的热门数据，也可以通过选择"提供方"进行进一步筛选。 5. 筛选到所需的数据offer后，单击offer名称，进入"offer详情"界面，可查看数据基本信息和数据列表信息。 6. 单击界面右上角"订阅"，在"订阅详情"界面中，编辑使用策略，相关参数说明如[表7]。 表7参数说明 | 参数 | 说明 | |:---|:---| | 已选操作 | 数据消费方自定义数据使用的限制方法，通过"约束条件"对查看、加工和下载进一步限制。 - 查看：用户可以查看资源文件详细信息。 - 加工：用户可以在预览的时候处理数据资源文件。 - 下载：用户可以下载数据资源文件到本地。 | | 约束条件 | 通过Who、When、How to、How many等几个方面限制数据消费方对数据的使用。 - Who：限定消费方的用户或团队进行数据交换。选择的用户需拥有数据接收者角色，才可以接收数据。选择的团队为消费方连接器下的某个团队。 - When：控制使用的时间，包括起始时间和截止时间。 - How many：限制可用操作的次数，默认不输入，则不限制次数。 | ![](https://support.huaweicloud.com/qs-eds/public_sys-resources/note_3.0-zh-cn.png) 订阅offer时，数据消费方可以在数据上架offer时提供的使用控制策略上申请新的策略，覆盖提供方的策略。 7. 输入订阅原因后，单击"确定"。 公开offer直接订阅成功，受控offer等待数据提供方审批。用户可在"工作台"的"我的任务"中选择"申请"页签查看申请任务的状态。 #### （可选）步骤5：审批订阅请求 如为公开offer直接订阅成功，受控offer需等待数据提供方审批。如下步骤由数据提供方进行操作。 1. 数据提供方进入[交换数据空间管理控制台](https://auth.huaweicloud.com/authui/login.html?service=https://console.huaweicloud.com/edsconsole/#/login)，单击"我的空间"，选择空间实例，单击实例卡片上的"连接器"。 2. 选择连接器，单击连接器卡片上的"前往"，进入连接器控制台界面。 3. 选择界面左侧导航栏中的"连接器管理 \> 申请待办"，进入"我的申请待办"界面。 4. 在界面下方选择"我的待办"页签，选择需要审批的"订阅审批"任务，单击"操作"列的"审批"。 5. 在"订阅审批"界面中，确认任务的基本信息，确认无误后单击"通过"。 6. 在弹出的"生成合约"对话框中，设置合约基本信息，相关参数说明如[表8]所示。 表8参数说明 | 参数 | 说明 | |:---|:---| | 合约名称 | 填写合约的名称，根据规划自定义。建议用户按照一定的命名规则填写合约名称，便于在数据合约进行区分。要求长度范围为2位\~50位。 | | 合约审批人 | 选择合约审批人，即选择形成合约的审批对象。 | | 合约描述 | 填写合约的简单描述信息，非必填项。 | | 合约说明 | 根据需求勾选"提供方可因政策或业务变化提前终止合约，并收回数据"。 | 7. 设置完成后，单击"确定"，完成订阅请求审批。 ![](https://support.huaweicloud.com/qs-eds/public_sys-resources/note_3.0-zh-cn.png) - 订阅审批后，会生成合约，等待数据提供方审批人审批合约通过后，数据消费方接收数据，合约审批请参考[（可选）步骤6：审批合约]。 - 审批人选择自己时跳过合约审批环节，接收方直接收到数据。当审批人选择其他用户时，需要走审批流程。 #### （可选）步骤6：审批合约 受控offer等待数据提供方审批订阅申请后生成合约申请，合约申请经过合约审批人审批后，数据消费方方可接收数据。如下步骤由数据提供方进行操作。 1. 数据提供方进入[交换数据空间管理控制台](https://auth.huaweicloud.com/authui/login.html?service=https://console.huaweicloud.com/edsconsole/#/login)，单击"我的空间"，选择空间实例，单击实例卡片上的"连接器"。 2. 选择连接器，单击连接器卡片上的"前往"，进入连接器控制台界面。 3. 选择界面左侧导航栏中的"连接器管理 \> 申请待办"，进入"我的申请待办"界面。 4. 在界面下方选择"我的待办"页签，选择需要审批的"合约审批"任务，单击"操作"列的"审批"。 5. 在"数据交换合约详情"界面中，确认任务的基本信息，确认无误后单击"通过"。 6. 在弹出的"生成合约"窗口中，填写"审批意见"，单击"确定"。 #### 步骤7：使用资源 如下步骤由数据消费方进行操作。 1. 数据消费方进入[交换数据空间管理控制台](https://auth.huaweicloud.com/authui/login.html?service=https://console.huaweicloud.com/edsconsole/#/login)，单击"我的空间"，选择空间实例，单击实例卡片上的"连接器"。 2. 选择连接器，单击连接器卡片上的"前往"，进入连接器控制台界面。 3. 选择界面左侧导航栏中的"数据目录"，选择"收到的数据"，进入"收到的数据"界面。 4. 在"收到的数据"界面，系统按照"按批次"和"按合约"两种方式展示，此处以"按批次"为例说明。 单击已生效的资源卡片右上角"归档"，参考[表9]选择归档路径，单击"确定"。 表9归档参数说明 | 参数 | 说明 | |:---|:---| | 指定路径归档 | 自定义路径归档，选择资源需要归档的路径地址。 | | 原路径归档 | 按提供方原始路径归档。 | | 自动归档 | 此合约下未归档的数据批次将自动归档到指定路径中，历史已手动归档的路径不变。 |