本页面介绍如何在 Dataproc Metastore 中使用辅助版本功能。
借助辅助版本，您可以将两个不同版本的 Hive Metastore 连接到单个 Dataproc Metastore 服务。此配置可让您支持需要在不同 Hive Metastore 版本上运行的多个数据处理引擎。
例如，使用辅助版本，您可以将多个 Managed Service for Apache Spark 集群连接到同一 Dataproc Metastore 服务。 在此配置中，一个集群可以运行 Managed Service for Apache Spark 2.0 版，而另一个集群运行 Managed Service for Apache Spark 1.5 版。Managed Service for Apache Spark 2.0 集群可以连接到公开 Hive 3.1.2 版的端点，而 Managed Service for Apache Spark 1.5 集群连接到公开 Hive 2.3.6 版的端点。
辅助版本的工作原理
启用辅助版本后，Dataproc Metastore 会为每个 Hive Metastore 版本公开一个单独的端点。不过，这两个端点仍共享同一个元数据数据库。
借助此功能，您无法在单个 Dataproc Metastore 服务中使用不同的元数据集。相反，它提供了一种扩展和增强服务之间兼容性的方法。
注意事项
常规
您只能为每个 Dataproc Metastore 服务创建一个辅助版本。
辅助版本必须配置为使用低于主要版本的 Hive Metastore 版本。
辅助版本维护一个与主要版本不同的日志文件。如需调试 Hive Metastore 问题，您可以使用 Cloud Logging。
功能支持
辅助版本不支持以下功能：
- 导入元数据、导出 元数据
从 Metastore 备份、 从 备份恢复 Metastore
与元数据相关的功能（导入/导出/备份/恢复）只能与主要版本搭配使用，因为这两个版本之间的后端元数据是共享的。
某些 Hive 方法可能在辅助版本和主要版本之间不兼容。这种兼容性取决于您为主要版本和辅助版本使用的 Hive 版本，以及 Hive 版本之间兼容的方法。
辅助版本不支持主要 Dataproc Metastore 实例的所有功能。例如，使用与辅助版本 2.3.6 交互的 Hive 2 客户端将记录插入到 Hive 事务表中不受支持。不过，使用与主要版本 3.1.2 交互的 Hive 3 客户端支持此操作。
如果较低 Hive 版本中的某项功能在较高 Hive 版本中已废弃，则相应的较低辅助版本将不支持该废弃的功能。例如，Hive 2 支持 索引，但如果主要 版本运行 Hive 3.1.2，则运行 Hive 2.3.6 的 辅助版本将不支持该索引。
系统会阻止使用辅助版本创建事务表，或在辅助版本中的事务表中插入任何数据。
版本之间的共享属性
创建辅助版本时，某些属性在辅助版本和主要版本之间是共享的，并且保持通用。其他属性不共享，并且在两个版本之间是分开的。
下表列出了这些差异。
| 属性 | 通用 | 分开 |
|---|---|---|
| 端点 | ✓ | |
| Hive 配置替换* | ✓ | |
| Kerberos 配置 | ✓ | |
| 端点协议 (Thrift/gRPC) | ✓ | |
| Thrift 端口 | ✓ | |
| 工件 Cloud Storage 存储桶 | ✓ | |
| 层级 | ✓ | |
| 维护时段 | ✓ | |
| 发布版本 | ✓ | |
| 加密配置 | ✓ | |
| 数据库类型 | ✓ | |
| Data Catalog 同步切换开关 | ✓ | |
| 请求计数指标 | ✓ | |
| 网络配置 | ✓ |
* Hive 配置替换在辅助版本和主要版本之间保持分开。不过，辅助版本引用了替换的合并列表（主要 + 辅助）。在这种情况下，辅助配置优先于主要配置。
准备工作
所需的角色
如需获得创建使用辅助版本的 Dataproc Metastore 所需的权限，请让您的管理员根据最小权限原则，向您授予项目的以下 IAM 角色：
- 授予对 Dataproc Metastore 资源的完全控制权限 (
roles/metastore.editor) - 授予对所有 Dataproc Metastore 资源的完全访问权限，包括 IAM 政策管理 (
roles/metastore.admin)
如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含
metastore.services.create
权限，
这是创建使用辅助版本的 Dataproc Metastore 所必需的。
为新服务创建辅助版本
以下示例显示了启用辅助版本时所遵循步骤的简略版本。如需了解必须遵循的 整个过程的完整分步说明，请参阅创建 Dataproc Metastore。
控制台
在 Google Cloud 控制台中，打开 Dataproc Metastore 页面：
在 Dataproc Metastore 页面顶部，点击创建 按钮。
此时会打开创建服务 页面。
在辅助版本配置 下，启用辅助版本。
点击添加辅助版本 。
输入辅助版本的名称。
为辅助版本选择一个版本。
可选：如要将映射应用于辅助版本，请点击 + 添加替换。
点击完成 。
点击提交 。
gcloud CLI
如需创建具有辅助 版本，请运行以下
gcloud metastore services create命令之一：gcloud metastore services create SERVICE \ --location=LOCATION \ --auxiliary-versions=AUXILIARY_VERSIONS, ...SERVICE：Dataproc Metastore 服务的名称。LOCATION：要在其中创建 Dataproc Metastore 服务的区域。AUXILIARY_VERSIONS：要为辅助版本部署的 Hive Metastore 版本的英文逗号分隔列表。 仅支持一个辅助版本。 使用以下格式"2.3.6"。AUXILIARY_VERSIONS_FROM_FILE：包含辅助版本配置的 YAML 文件的路径。如需了解详情和示例，请参阅 SDK 文档。
验证创建操作是否成功。
curl
如需创建具有辅助版本的 Dataproc Metastore 服务，
请使用 create 方法。
curl -X POST -s -i \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-d '{"network":"projects/PROJECT_ID/global/networks/default", "port": 9083, "hive_metastore_config": {"auxiliary_versions": {"aux-version1": {"version": "AUX_VERSION"} } } }' \
-H "Content-Type:application/json" \
https://metastore.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/services?service_id=SERVICE_ID
替换以下内容：
SERVICE_ID：新 Dataproc Metastore 服务的名称。PROJECT_ID：要在其中创建 Dataproc Metastore 服务的 Google Cloud 项目 ID。LOCATION：Dataproc Metastore 所在的区域。AUX_VERSIONS：要部署的 Hive Metastore 版本的英文逗号分隔列表。仅支持一个辅助版本。
更新现有服务的辅助版本
以下说明介绍了如何更新使用辅助版本的现有 Dataproc Metastore 服务。
运行更新操作时，您可以完成以下任务：
- 添加新的辅助版本。
- 删除现有辅助版本。
添加或修改现有辅助版本的替换。
控制台
在 Google Cloud 控制台中，打开 Dataproc Metastore 页面：
在 Dataproc Metastore 页面上，点击您要更新的服务的名称。
此时会打开服务详细信息 页面。
在配置 标签页上，点击修改 。
此时会打开修改服务 页面。
在 辅助版本配置 部分，点击切换开关以启用 或停用辅助版本。
您可以完成以下任务：
如需删除现有辅助版本，请点击删除 。
如需添加新的辅助版本，请点击添加辅助版本 。
如需将替换映射应用于辅助版本，请点击 + 添加替换。
点击提交 。
gcloud CLI
如需更新使用辅助版本的 Dataproc Metastore 服务， 请运行以下
gcloud metastore services update命令之一：gcloud metastore services update SERVICE \ --location=LOCATION \ --add-auxiliary-versions=AUXILIARY_VERSIONS, ...
或
gcloud metastore services update SERVICE \ --location=LOCATION \ --update-auxiliary-versions-from-file=AUXILIARY_VERSIONS_FROM_FILE
替换以下内容：
SERVICE：Dataproc Metastore 服务的名称。LOCATION：Dataproc Metastore 所在的区域。AUXILIARY_VERSIONS：要部署的辅助 Hive Metastore 版本的英文逗号分隔列表。AUXILIARY_VERSIONS_FROM_FILE：包含辅助版本配置的 YAML 文件的路径；如需了解详情和示例，请参阅 SDK 文档。
验证更新是否成功。
curl
如需更新使用辅助
版本的 Dataproc Metastore 服务，请使用 patch 方法。
curl -X PATCH -s -i \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-d '{"hive_metastore_config": {"auxiliary_versions": {"aux-version1": {"version": "AUX_VERSION} } } }' \
-H "Content-Type:application/json" \
https://metastore.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/services/SERVICE_ID?update_mask=hive_metastore_config.auxiliary_versions
替换以下内容：
SERVICE_ID：Dataproc Metastore 服务的名称。PROJECT_ID：要在其中创建 Dataproc Metastore 服务集群的 Google Cloud 项目 ID。LOCATION：Dataproc Metastore 所在的区域。AUX_VERSIONS：要部署的辅助 Hive Metastore 版本的英文逗号分隔列表。