华为云用户手册

重复数据删除管理 随着HANA数据快速增长，以及企业要求备份和恢复的时间点越来越多，保存数据的成本也变得越来越严重。研究发现，SAP HANA备份数据中的数据中高达60%是冗余的，重复率很高，随着时间的推移，重复数据越来越多。为了缓解存储系统的空间增长问题，缩减数据占用空间、降低成本，最大程度地利用已有资源，重复数据删除已成为存储领域一个热门的技术。一方面，利用重复数据删除技术可以对存储空间的利用率进行优化，消除分布在存储系统中的相同文件或者数据块。另一方面，利用重复数据删除技术可以减少在网络中传输的数据量，进而降低能量消耗和网络成本，并为数据复制大量节省网络带宽。 Commvault将源端和目标端重复数据删除功能完全集成到统一数据管理平台中，在将备份数据通过网络发送到服务器和存储器之前，先在源端进行重复数据删除，以消除冗余的数据。Commvault重复数据删除，实现了更短的备份窗口、更低网络带宽占用、更低的存储成本以及更可靠的数据保护。 Commvault采用基于数据块级别的重复数据删除技术，利用SHA 512 (Secure Hash Algorithm)算法来比对数据块是否重复，SHA512是目前为止最为安全的散列算法。Commvault具有内容感知功能，智能切割备份/归档数据块，快速识别备份/归档数据中的相同数据块，并确保相同数据块在存储设备上只保留一次。 Commvault去重主要由MediaAgent来负责管理，MediaAgent管理3个部分： 去重数据库 去重数据用来比对数据块的哈希值，去重数据库的性能，会影响重复数据删除的性能。建议采用高IO磁盘存储，例如：华为云中的超高IO云硬盘。 备份/归档索引 记录数据块的逻辑与物理位置信息，通过索引，可以知道一个数据文件由那些数据块所组成，要利用索引来进行数据恢复，数据恢复并不需要访问去重数据库。建议采用高IO磁盘存储，例如：华为云中的超高IO云硬盘。 去重数据存储空间 用于存放去重的物理数据块，通常是大容量的通用磁盘存储，可以是 云存储 、DAS、SAN或NAS磁盘存储设备。云中建议采用S3存储，如：华为云中的 对象存储服务 OBS。 Commvault的DDB数据库是MemDB（主存数据库）。MemDB能提供更高的性能，但MemDB最好存放在SSD磁盘上或其他高速磁盘上。一个DDB数据库，可根据用户的环境，选择不同的配置，具体如表3所示。 表3 DDB数据库配置 规模 前端容量 DDB数据库 后端容量 并发流数 Xsmall 5 TB~15 TB 200 GB 25 TB 25 Small 10 TB~30 TB 400 GB 50 TB 50 Medium 30 TB~60 TB 600 GB 75 TB 100 Large 60 TB~125 TB 1.2 TB 150 TB 200 Xlarge 110 TB~150 TB 2 TB 250 TB 300

多副本管理 利用Commvault平台能轻松实现多副本管理，比如做D2C2C备份，或D2C2T备份。把备份副本复制到云存储或本地数据中心的磁带库上。 Aux Copy（辅助拷贝）是备份数据的复制操作，把数据从一个副本复制到另外一个副本，用于创建多副本或DR（灾难恢复）备份。 图6 多副本复制 辅助拷贝可实现不同介质之间的数据复制，去重副本的辅助拷贝，称为DASH Copy，仅复制新的数据块。存储策略中含三种类型副本： Primary 主副本，备份操作时，数据先只能写入主副本。 Synchronous 同步副本，利用AuxCopy产生的次级副本，数据内容与主副本完全相同。 Selective 选择副本，利用AuxCopy产生的次级副本，数据内容只选择全备份数据。

Storage Accelerator 客户端计算机将数据备份到云存储时，软件将通过MediaAgent路由数据。因此，客户端计算机首先将数据发送给MediaAgent，然后MediaAgent将数据发送给云存储库。使用客户端存储加速器“Storage Accelerator”可以加快备份过程，直接将数据发送到配置的云存储库，具体如图5所示。 对于运行在云中的SAP HANA系统，这是一个非常有用的特性。对于大型单节点HANA系统，它允许从集中的介质管理服务器分流数据流，对于多节点HANA系统，随着节点数量的增加，它提供接近线性的可伸缩性。 图5 Storage Accelerator备份流程

SAP HANA备份架构 图1 SAP HANA备份架构图 图1是一个典型的SAP HANA多节点备份拓扑架构图，在HANA节点服务器上安装Commvault的SAP HANA备份代理模块iDA for SAP HANA，Commvault的备份管理服务器 CS 管理备份策略和调度备份计划，介质代理服务器MA负责连接OBS对象存储，并将备份数据去重后写入到OBS对象存储中。 对于数据量较大的HANA，Commvault提供了“Storage Accelerator”存储加速功能，可提升备份和恢复性能。 Commvault备份软件的组件如下： 管理服务器（CommServe，即上图中CS） CommServe集中管理CommCell中所有软件组件，协调并执行CommCell中所有操作，CommServe包含一个Microsoft SQL Server数据库，用来记录所有的配置信息、安全属性以及操作历史以及Metadata。在一个CommCell中，只能有一个CommServe，CommServe可以安装在物理服务器、虚拟服务器或集群环境中。 华为云中的云服务器推荐如表1所示。 表1 推荐的云服务器 规模 客户端数量 服务器配置 云服务器规格 Small 25 servers, or 100 virtual machines 4 CPU cores, 16 GB RAM c6.xlarge.4 Medium 500 servers, or 1000 virtual machines 8 CPU cores, 32 GB RAM c6.2xlarge.4 Large 2500 servers, or 5000 virtual machines 12 CPU cores, 64 GB RAM c6.4xlarge.4 Xlarge 10,000 servers, or 20,000 virtual machines 16 CPU cores, 128 GB RAM m3.4xlarge.8 介质代理（MediaAgent，即上图中MA） MediaAgent在CommCell中负责管理数据传输，管理数据存储的介质库：磁盘库、磁带库、云存储等。CommServe指挥并协调MediaAgent执行任务，在一个CommCell中可以部署多台MediaAgent来拓展性能，MediaAgent可以安装在物理服务器、虚拟服务器或集群环境中，能支持Window、Linux和Unix操作系统。 华为云中的云服务器推荐如表2所示。 表2 推荐的云服务器 规模 客户端数量 服务器配置 后端容量 云服务器规格 Xsmall 5 TB~15 TB 2 CPU cores, 16 GB RAM 25 TB m6.large.8 Small 10 TB~30 TB 4 CPU cores, 24 GB RAM 50 TB m6.xlarge.8 Medium 30 TB~60 TB 8 CPU cores, 32 GB RAM 75 TB c6.2xlarge.4 Large 60 TB~125 TB 12 CPU cores, 64 GB RAM 150 TB c6.4xlarge.4 Xlarge 110 TB~150 TB 16 CPU cores, 128 GB RAM 250 TB m6.4xlarge.8 客户端（Client，即上图中iDA） 被保护及被管理的生产服务器称为客户端，通常会在客户端上安装软件代理模块，或为客户端配置一个代理服务器上软件代理模块，来实现数据保护、管理及传输。

SAP HANA数据库备份及恢复策略 对SAP HANA数据库可以进行全备份、增量备份、差量备份和日志备份。备份策略可按图3进行编排。 图3 备份策略 全备份 全备份是备份数据库数据卷上的所有数据，一般放在周末进行，对系统影响比较小。 增量备份 增量备份收集了上次任何备份后的数据，在一天当中可以进行多次增量备份，比如可以在早上、中午、晚上结算前进行增量备份。 差量备份 差量备份收集了上次全备份后的变化数据，一般在每天晚上结算后进行。 日志备份 对数据卷的备份可以是手动或按备份计划进行，而日志的备份都是自动进行的，默认情况下，每15分钟做一次日志备份，当然备份的频率是可根据用户的需求进行调整的。 日志备份非常重要，如果持久性存储上的日志不备份，日志是不能被删除的，大量的日志会把日志存储区填满，导致数据库被锁起来。 Commvault在SP16以后默认情况下，SAP HANA代理将所有数据库服务中的日志文件备份为每6小时一次持久日志备份作业。可以集中持续的将所有服务的日志统一备份，减少备份作业的数量。 可以利用备份，把SAP HANA数据库恢复到某一个时间点，恢复的次序是： 恢复最后全备份。 恢复最后差量备份。 恢复接下来的所有增量备份。 恢复接下来的日志备份。 恢复到最新：如果Log区中的日志没有丢失，数据将没有损失。 恢复到指定的时间点：逻辑错误会导致最新数据是不正确的，因此需要恢复到以前某一个时间点。 在图4中，恢复一个全备份，最近的差量备份（D3）和最新的一个增量备份（I4），再进行一个日志前滚操作，就能完成数据的最新恢复。 图4 数据恢复

如何保护SAP HANA数据库 SAP HANA是内存数据库，数据库运行时，数据都放在内存中，如何备份HANA数据库呢？为了更好理解HANA数据库的备份原理，首先我们分析下HANA数据保护机制。大家都知道当服务器断电时，放在内存里的数据就会全丢失，为了避免这类内存故障，HANA数据库会定时把数据存储到持久性存储（磁盘）上，主要有以下两个机制： 保护点（Savepoint） HANA数据库定时会发起保护点操作，默认是5分钟进行一次，保护点操作会把数据库中的数据及Undo信息一起写入到磁盘上，Undo信息中包含了未提交的事务。HANA系统能从保护点进行完全恢复。 重做日志（Redo） 数据库的事务也会记录在内存中的Redo日志缓存中，默认Redo缓存为1MB，当事务被提交或当日志缓存写满时，HANA数据库会把缓存中的Redo日志写到磁盘上。利用Redo日志，可以把HANA数据库恢复到保护点后的某一个时间点。 利用持久性存储，HANA可以防止任何内存故障，但一旦持久性存储发生故障，HANA数据仍然会被破坏而无法恢复。需要利用备份来保护持久性存储上的数据，把持久性存储上的数据备份到外部存储上，这样才能达到数据保护目的。在数据备份时先会触发一个保存点（Savepoint），确保持久性存储上的数据具有数据库一致的映像，确保数据库可恢复。目前，SAP数据备份支持在线全备份、增量备份、差量备份。备份过程不具备中断再续的能力，如果备份过程中发生错误，整个数据库备份将从头再来。 持久性存储上的Redo日志也需要备份到外部存储上，如果持久性存储上的日志不备份，日志是不能被删除的，大量的日志会把日志存储区填满，导致数据库被锁起来。图2是数据备份和日志备份的示意图。 图2 数据备份和日志备份示意图

概述 一个典型的SAP HANA单节点的文件系统示例如表1所示： 表1 SAP HANA文件系统 文件系统 推荐的文件系统类型 使用的华为云云服务 用途 / ext4 云硬盘 OS卷 /usr/sap xfs 云硬盘 SAP系统目录 /hana/log xfs 云硬盘 HANA Log卷 /hana/data xfs 云硬盘 HANA Data卷 /hana/shared xfs 云硬盘 HANA Shared卷 /hana/backup nfs 弹性文件服务 HANA备份文件存放目录，后续简称Backup目录 根据SAP官方文档《SAP HANA管理员指南》中的描述，SAP HANA支持如下备份与恢复的功能： 全量备份 Data文件备份 Data卷快照 Delta备份 增量备份 差异备份 Redo log备份 使用第三方软件的备份与恢复 备份完整性检查 备份生命周期管理 指定时间点的恢复（PITR） 指定Data卷文件备份或Data卷快照的恢复（不使用Log卷备份） 使用备份与恢复拷贝新数据库 以上备份功能，按照备份方式，可分为以下三类： 基于文件的备份 基于存储快照的备份 基于Backint接口的第三方软件的备份 不同场景所需要的备份数据如表2所示： 表2 不同场景的备份数据 场景 所需要的备份数据 恢复SAP HANA到最近的状态 最近的Data备份（基于文件的备份、基于存储快照的备份或基于Backint的备份） Data备份后的Log备份 Log区数据 恢复SAP HANA到指定时间点（PITR） 最近的Data备份（基于文件的备份、基于存储快照的备份或基于Backint的备份） Data备份后的Log备份（包括此时间点之后的日志备份） Log区数据 恢复SAP HANA到指定数据备份或者存储快照 指定的数据备份（基于文件的备份、基于存储快照的备份或基于Backint的备份） 恢复SAP HANA到某个Log位置 Log位置之前的Data备份（基于文件的备份、基于存储快照的备份或基于Backint的备份） Data备份后的Log备份 Log区数据 父主题： SAP HANA备份与恢复方案

备份策略示例 操作系统的备份策略示例 灾难发生时，为了快速还原系统，省去SAP应用的安装及OS层的配置工作，以达到客户所需要的RTO， 一般建议每个系统都要做操作系统层面的备份，建议开发测试系统每半年或当系统有升级或其他重大调整前后备份一次，至少保留一份，生产系统系统每季度或当系统有升级或其他重大调整前后备份一次，至少保留二份。操作系统的备份策略示例如表1所示。 表1 操作系统的备份策略示例 备份对象 备份内容 备份频率 保留周期 备注 开发系统应用&数据库 操作系统 （包括/etc，/home等） 每6个月备份1次 1年 每次系统有升级或其他重大调整前需备份一次 测试系统应用&数据库 每6个月备份1次 1年 生产系统应用&数据库 每3个月备份1次 1年 重要文件系统的备份策略示例 灾难发生时，为了快速还原系统，除了操作系统的定期备份，您还需要对操作系统变更频繁的重要文件系统目录备份，比如传输目录/usr/sap/trans、 /sapmnt或者客户自定义的其它目录。重要文件系统的备份策略示例如表2所示。 表2 重要文件系统的备份策略示例 备份对象 备份内容 备份频率 保留周期 开发系统应用 /sapmnt，/usr/sap，/etc，/home以及其它目录 每周备份1次 2周 测试系统应用 每周备份1次 2周 生产系统应用 每周备份2次 1月 父主题： SAP应用备份与恢复方案

概述 本文档主要介绍如何在华为云上进行SAP系统的备份与恢复，重点描述华为云上备份与恢复方案中特殊的部分，本文档不可替代SAP或各数据库的官方文档。 本文档中涉及SAP软件或各数据库的约束与规格，如果出现与官方文档冲突时，请以官方文档为准。 本文档假定您已经熟悉在华为云上进行SAP系统的部署与操作。如果您初次接触华为云SAP解决方案，建议您在阅读本文档前，先阅读以下文档： SAP部署指南 SAP HANA用户指南（单节点） SAP NetWeaver用户指南 您也可以通过访问SAP官网阅读华为云相关的SAP说明，具体如表1所示。 表1 华为云相关SAP Notes SAP Note # 标题 2582296 SAP Applications on Huawei Cloud: Supported Products and Huawei Cloud VM types 2582305 SAP on Huawei Cloud: Support prerequisites 2570214 Linux on Huawei Cloud: Adaption of your SAP License 2570198 SAP on Linux with Huawei Cloud: Enhanced Monitoring 2644322 SAP Adaptive Server Enterprise (ASE) 16.0 Certification Report for Huawei Cloud

URI GET /v1/{project_id}/tags/value 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String project_id 表2 Query参数 参数 是否必选 参数类型 描述 type 是 String 参数解释： 标签类型，分为用户标签及用户组标签。 约束限制： 不涉及 取值范围： 以下枚举值： user：用户类型标签； userGroup：用户组类型标签。 默认取值： 不涉及 offset 否 Integer 返回条目的起始offset，默认值0。 limit 否 Integer 返回条目数，默认值10。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Workspace-Id 是 String 工作空间ID。获取方法请参见获取工作空间ID。 X-Auth-Token 是 String 用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 导出包名称。 export_param 否 ResourcePackageExportParam object 导出高级参数。 resources 是 Array of objects 导出资源明细。 表4 ResourcePackageExportParam 参数 是否必选 参数类型 描述 export_dataset_tag_permission 否 Boolean 是否携带数据集行权限-标签授权。 表5 resources 参数 是否必选 参数类型 描述 resource_type 是 String 参数解释： 资源类型枚举值，用于指定授权对象的类型。 示例：datasource，指定授权对象类型为数据源。 约束限制： 不涉及 取值范围： 以下枚举值： datasource：数据源； dataset：数据集； metric：指标； dashboard：仪表板； screen：大屏； embedAnalysis：嵌入分析； portal：数据门户； subject：智能分析助手。 默认取值： 不涉及 resource_id 是 String 资源ID。

响应示例 状态码： 200 查询资源列表成功。 { "count" : 1, "page_data" : [ { "id" : "e2xxxx66f-81bxxxxxx9c38-80xxx0fxx9c84", "name" : "未命名大屏1", "create_user_name" : "dat***ig***", "create_date" : 1707215155901, "update_user_name" : "dat***ig***", "update_date" : 1707215155901, "status" : 0 } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Integer 总数。 page_data Array of 表5 objects 分页数据。 表5 ResourceVO 参数 参数类型 描述 id String - name String 资源名称。 create_user_name String 创建者。 create_date Integer 创建日期。 update_user_name String 更新者。 update_date Integer 更新日期。 status Integer 发布状态。

URI GET /v1/{project_id}/resources/{resource_type} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 resource_type 是 String 参数解释： 资源类型枚举值，用于指定授权对象的类型。 示例：datasource，指定授权对象类型为数据源。 约束限制： 不涉及 取值范围： 以下枚举值： datasource：数据源； dataset：数据集； metric：指标； dashboard：仪表板； screen：大屏； embedAnalysis：嵌入分析； portal：数据门户； subject：智能分析助手。 默认取值： 不涉及 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移值。 limit 否 Integer 返回列表数量。 sort_key 否 String 排序字段。 sort_dir 否 String 排序类别： desc：倒序。 asc：正序。

URI GET /v1/{project_id}/quota-users 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参见获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 account_name 否 String 用户名（模糊搜索）。 sys_role 否 String 系统角色： 1通用角色； 2只读用户。 type 否 String 角色类型： IAM 、SELF-BUILT sort_key 否 String 排序字段：effectiveTime、accountName sort_dir 否 String 排序方式：desc、asc offset 否 Integer 页数，默认0。 limit 否 Integer 每页数据数，默认10。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Integer 数据总量。 page_data Array of 表5 objects 数据。 表5 page_data 参数 参数类型 描述 user_id String 用户id。 account_name String 用户名称。 user_type String 用户类型：IAM、SELF-BUILT、DEFAULT。 sys_role Integer 用户角色： 0未激活； 1通用角色； 2只读用户。 枚举值： 0 1 2 effective_time Long 生效时间戳。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Workspace-Id 是 String 工作空间ID。获取方法请参见获取工作空间ID。 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取IAM用户Token接口，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 ids 是 Array of strings 执行批量操作仪表板ID列表。

操作步骤 登录智能数据洞察控制台。 单击管理控制台左上角的，选择区域。 单击左下角的企业项目选择企业项目。 选择项目。 选择待授权的大屏。 单击大屏操作列“更多”，在弹出的页面内单击“分享协作”。 在协同授权配置页面编辑大屏权限。 选择授予的权限。 编辑授权：打开后可赋予成员编辑权限，支持编辑和删除大屏，同时支持基于大屏进行数据分析。 开启大屏的编辑权限，默认关联开启大屏的使用/查看权限。 导出授权：打开后可赋予成员使用权限。支持对大屏的分析，同时支持基于大屏进行数据分析。 查看权限：打开后可赋予成员使用权限，仅支持基于大屏进行数据分析。 选择授权的对象。 用户：给当前用户编辑大屏的权限。 用户组：当给该用户组授权后，整个组内的用户都将获得该大屏的相关权限。 按需勾选需要授权的用户和用户组，完成数据源授权。 图1 协同授权配置页面

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取IAM用户Token接口，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 user_name_list 是 Array of strings 用户名称列表。 sys_role 是 Integer 通行证角色： 0未激活； 1通用用户； 2只读用户。

URI GET /v1/{project_id}/tags/download 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 项目ID。获取方法请参见获取项目ID。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 表2 Query参数 参数 是否必选 参数类型 描述 type 是 String 参数解释： 用户类型。 约束限制： 不涉及 取值范围： user：用户 userGroup：用户组 默认取值： 不涉及

响应参数 表3 响应Body参数 参数 参数类型 描述 id String 任务ID。 name String 导入名称。 domain_id String domainID。 project_id String 项目ID。 workspace_id String 工作空间ID。 import_param String 导入参数清单。 obs_bucket String obs桶名称。 obs_object_key String obs对象路径。 import_detail String 导入明细。 status Integer 结果状态：-1:未激活 0：待处理 1：成功；2：失败；3：部分成功 4：处理中。 枚举值： -1 0 1 2 3 4 error_msg String 任务失败原因。 import_type String import：资源包导入；crossSpaceImport：跨空间一键导入。 create_user String 创建者ID。 create_user_name String 创建者名称。 create_date Long 创建时间戳。 update_date Long 更新时间戳。

响应示例 导入任务详情。 { "id" : "2406a337-xxxx-a5b2-b01a61d2043b", "name" : "string", "domain_id" : "ad9e2f08-xxxx-87eb-1f9619b6c313", "project_id" : "string", "workspace_id" : "12913c92-xxxx-b8fd-a72af3945b61", "import_param" : "", "obs_bucket" : "test", "obs_object_key" : "test.zip", "import_detail" : "导入成功【 导出资源清单 】 数据源: 1 ;【 导入参数清单 】: 目标工作空间: 示例工作空间 ; 是否替换: false ;是否携带权限信息：false", "status" : 1, "error_msg" : "string", "import_type" : "import|crossSpaceImport", "create_user" : "string", "create_user_name" : "string", "create_date" : 9223372036854776000, "update_date" : 9223372036854776000 }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 embed_id 是 String 嵌入分析id。 user_id 是 String 用户id。 group_ids 否 Array of strings 用户组id列表。 ticket_num 否 Integer ticket使用次数。 session_auto_renew 否 Boolean 是否允许session自动延期。 缺省值：false

请求示例 查询资源血缘关系。 POST https://{endpoint}/v1/0e****127d****6b7****95750da/resources/relationships { "resources" : [ { "resource_type" : "portal", "resource_id" : "96334c9****4510a0035dff29a7582b" } ] }

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 resources Array of ResourceRelationDetailVO objects 资源血缘关系列表。 workspace_id String 工作空间ID。获取方法请参见获取工作空间ID。 表6 ResourceRelationDetailVO 参数 参数类型 描述 resource_id String 资源ID。 resource_name String 资源名称。 resource_type String 参数解释： 资源类型枚举值，用于指定授权对象的类型。 示例：datasource，指定授权对象类型为数据源。 约束限制： 不涉及 取值范围： 以下枚举值： datasource：数据源； dataset：数据集； metric：指标； dashboard：仪表板； screen：大屏； embedAnalysis：嵌入分析； portal：数据门户； subject：智能分析助手。 默认取值： 不涉及 relations Array of ResourceRelationDetailVO objects 依赖资源列表。

响应示例 状态码： 200 查询资源血缘关系成功。 { "resources" : [ { "resource_id" : "96334c9923****0a0035dff29a7582b", "resource_name" : "测试数据门户", "resource_type" : "portal", "relations" : [ { "resource_id" : "2545c456-****-a6d4-dd8419cac54a", "resource_name" : "大屏", "resource_type" : "screen", "relations" : [ ] }, { "resource_id" : "12e25f5f-4*****-8468-bdf69c25438f", "resource_name" : "仪表板", "resource_type" : "dashboard", "relations" : [ { "resource_id" : "980bc5e2-******4-a168-4d344065bcb3", "resource_name" : "数据集", "resource_type" : "dataset", "relations" : [ { "resource_id" : "c4d84a8******ba190c5cabf75dfe", "resource_name" : "datasource", "resource_type" : "datasource", "relations" : [ ] } ] } ] } ] } ], "workspace_id" : "e10aa3****e713d779c65e74" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Workspace-Id 是 String 工作空间ID。获取方法请参见获取工作空间ID。 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取IAM用户Token接口，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 resources 是 Array of resources objects 待查询血缘关系的资源信息列表。 表4 resources 参数 是否必选 参数类型 描述 resource_type 是 String 参数解释： 资源类型枚举值，用于指定授权对象的类型。 示例：datasource，指定授权对象类型为数据源。 约束限制： 不涉及 取值范围： 以下枚举值： datasource：数据源； dataset：数据集； metric：指标； dashboard：仪表板； screen：大屏； embedAnalysis：嵌入分析； portal：数据门户； subject：智能分析助手。 默认取值： 不涉及 resource_id 是 String 资源ID。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 description 否 String description name 是 String name type 是 String 参数解释： 标签类型，分为用户标签及用户组标签。 约束限制： 不涉及 取值范围： 以下枚举值： user：用户类型标签； userGroup：用户组类型标签。 默认取值： 不涉及 default_value_type 是 String 默认标签值类型，默认为NULL。 NULL：为空； ALL：所有值； ENUM：枚举值，default_value必须有枚举值配置。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 id 否 String 嵌入分析id。传入该参数则使用传入的id，否则生成新id。 name 是 String 嵌入分析名称。 resource_type 是 String 参数解释： 资源类型枚举值，用于指定授权对象的类型。 示例：datasource，指定授权对象类型为数据源。 约束限制： 不涉及 取值范围： 以下枚举值： datasource：数据源； dataset：数据集； metric：指标； dashboard：仪表板； screen：大屏； embedAnalysis：嵌入分析； portal：数据门户； subject：智能分析助手。 默认取值： 不涉及 resource_id 是 String 嵌入分析对应的资源id，如仪表板或者大屏的id。 root_resource_id 是 String 嵌入分析对应的根资源id。仪表板或者大屏的根资源id为其本身id。 auth_type 否 String 嵌入分析的访问类型。0：登录访问；1：ticket认证。默认取值为0。 config 否 String 嵌入分析配置参数。如'ticket=xxxx'，则指定嵌入分析链接里对应的ticket值。

请求示例 创建嵌入分析。 POST https://{endpoint}/v1/{project_id}/embeddings { "id" : "6cb08a50xxxxxxxxxxxxxxxxxxxxxx", "name" : "新建嵌入分析", "resource_type" : "dashboard", "resource_id" : "866a519fxxxxxxxxxxxxxxxx", "root_resource_id" : "866a519fxxxxxxxxxxxxxxxx", "config" : "ticket=ec85f874axxxxxxxxxxxxxxxxxxxxxxxxxxxx", "auth_type" : 1 }