更新主题 SMT

本文档介绍了如何更新 Pub/Sub 主题的单条消息转换 (SMT)。对 SMT 所做的更改会在几分钟内生效。对于主题 SMT，更改适用于更新 SMT 后发布的新消息。

如需更新主题 SMT，您可以使用 Google Cloud 控制台、Google Cloud CLI、客户端库或 Pub/Sub API。

所需的角色和权限

如需获得更新主题 SMT 所需的权限，请让您的管理员为您授予项目的 Pub/Sub Editor (roles/pubsub.editor) IAM 角色。 如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色包含更新主题 SMT 所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

如需更新主题 SMT，您需要具备以下权限：

  • 向更新授予主题的发布权限： projects.topics.patch
  • 向视图授予项目的查看主题权限。只有在使用 Google Cloud 控制台时，才需要此权限： pubsub.topics.view

您也可以使用自定义角色或其他预定义角色来获取这些权限。

您可以在项目级层和个别资源级层配置访问权限控制。

更新主题 SMT

如需更新主题 SMT，请按以下步骤操作：

控制台

  1. 在 Google Cloud 控制台中，前往 Pub/Sub 主题页面。

    转到“主题”

  2. 点击要修改 SMT 的主题。

  3. 在主题详情页面中，点击修改。

    转换标签页列出了附加到主题的所有 SMT。

  4. 在“修改主题”页面中，您可以执行以下任务：

    1. 添加新的 SMT。点击添加转换。

    2. 修改现有 SMT。展开任意 SMT 以修改该 SMT。

    3. 重新排列 SMT。使用向上和向下箭头键。

    4. 删除 SMT。点击“删除”按钮。

  5. 点击更新。

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. 运行 gcloud pubsub topics update 命令：

    gcloud pubsub topics update TOPIC_ID \
    --message-transforms-file=TRANSFORMS_FILE

    替换以下内容：

    • TOPIC_ID：要更新的主题的 ID 或名称。

    • TRANSFORMS_FILE：包含更新后的 SMT 的 YAML 或 JSON 文件的路径。

      以下是 YAML 转换文件的示例：

      - javascriptUdf:
    code: >
        function redactSSN(message, metadata) {
          const data = JSON.parse(message.data);
          delete data['ssn'];
          message.data = JSON.stringify(data);
          return message;
        }
    functionName: redactSSN
- javascriptUdf:
    code: >
        function filterHighAmount(message, metadata) {
          const data = JSON.parse(message.data);
          if (data['amount'] > 100 ) { return null; }
          return message;
        }
    functionName: filterHighAmount

    如需清除主题中的所有 SMT，请使用以下命令：

    gcloud pubsub topics update TOPIC_ID --clear-message-transforms

    将 TOPIC_ID 替换为您要更新的主题的 ID 或名称。

后续步骤