Atlas Server 实体类型

背景

AtlasServer 实体类型在以下方面是特殊的实体类型：

• 在导出或导入操作期间创建。
• 它还具有特殊的属性页，用于显示导出和导入操作的详细审计信息。
• 实体通过实体属性中的新选项 SoftReference 与之关联。

该新类型在 基本（Basic） 和 高级（Advanced） 搜索的 按类型搜索（Search By Type） 下拉列表中均可使用。

创建

每当导出和导入操作成功完成时，都会创建此类型的实体。实体以当前集群的名称创建。

实体还会根据导出和导入请求的 replicatedTo 和 replicatedFrom 参数创建。

属性页中的详情

AtlasServer 实体的属性页有一个额外的标签页“导出/导入审计（Export/Import Audits）”。其中包含当前 Atlas 实例上执行的每次导出和/或导入操作的详细审计记录。

additionalInfo 属性将在下文详细说明。

导出/导入审计

该表格包含以下列：

• 操作（Operation）：EXPORT 或 IMPORT，表示在实例上执行的操作类型。
• 源服务器（Source Server）：对于在本实例上执行的导出操作，此列的值始终是当前 Atlas 实例的集群名称。即 atlas-application.properties 中由 atlas.cluster.name 键指定的值。若未指定该值，则使用 'default'。
• 目标服务器（Target Server）：如果导出操作在请求中指定了 replicatedTo 属性，则该值会显示在此处。
• 操作开始时间（Operation StartTime）：操作开始的时间。
• 操作结束时间（Operation EndTime）：操作完成的时间。
• 工具（Tools）：弹出的属性页，包含操作的详细信息。

示例

以下导出请求最终会创建一个名称为 clMain 的 AtlasServer 实体。该操作的审计记录将显示在此实体的属性页中。

{
    "itemsToExport": [
        { "typeName": "hive_db", "uniqueAttributes": { "qualifiedName": "stocks@cl1" }}
    ],
    "options": {
        "replicatedTo": "clMain"
    }
}

集群全名支持

通常有必要通过指定 Atlas 实例所在的位置或数据中心来消除集群名称的歧义。

集群名称可以通过用 '$' 分隔位置名称和集群名称来指定。例如，指定为 'SFO$cl1' 的集群名称，可以表示位于旧金山（SFO）数据中心、名称为 'cl1' 的集群。

AtlasServer 会处理这一情况，并将其 name 设置为 'cl1'，fullName 设置为 'SFO@cl1'。

附加信息

AtlasServer 中的该属性是一个键和值均为 String 的映射（map），可用于存储与该实例相关的任何信息。

有关如何使用该属性的示例，请参阅增量导出。

REST API

CURL

curl -X GET -u admin:admin -H "Content-Type: application/json" -H "Cache-Control:no-cache" http://localhost:21000/api/atlas/admin/server/cl2

（未提供需要翻译的 Markdown 原文，请粘贴要翻译的内容。）

{
    "guid": "f87e4fd1-bfb5-482d-9ab1-e735621b7d16",
    "name": "cl2",
    "qualifiedName": "cl2",
    "additionalInfo": {
        "nextModifiedTimestamp": "1533037289383",
        "replicationOperation": "EXPORT",
        "topLevelEntity": "stocks@cl1"
    }
}