Pulsar Topics（主题）和 Namespaces（命名空间）

1、Topics（主题）

2、Namespaces（命名空间）

1、Topics（主题）

和其他发布订阅（pub-sub）系统一样，主题在 pulsar 中也是一个被命名的频道，用来让生产者向消费者传输消息。主题名称则是按照一定结构进行定义的 urls：

{persistent|non-persistent}://tenant/namespace/topic

Topic name component Description

Topic name component	Description
`persistent` / `non-persistent` 主题类型	This identifies the type of topic. Pulsar supports two kind of topics: persistent and non-persistent. The default is persistent, so if you do not specify a type, the topic is persistent. With persistent topics, all messages are durably persisted on disks (if the broker is not standalone, messages are durably persisted on multiple disks), whereas data for non-persistent topics is not persisted to storage disks. // 定义主题的类型。Pulsar支持两种类型主题：持久性和非持久性。默认值是持久的，因此如果不指定类型，则主题是持久的。对于持久主题，所有消息都会持久保存在磁盘上（如果有多个代理，则消息会持久保存在多个磁盘上），而非持久主题的数据不会持久保存到存储磁盘上。
`tenant` `租户`	The topic tenant within the instance. Tenants are essential to multi-tenancy in Pulsar, and spread across clusters. // 实例中的主题租户。租户分布在集群中，在Pulsar多租户机制中非常重要。
`namespace` `命名空间`	The administrative unit of the topic, which acts as a grouping mechanism for related topics. Most topic configuration is performed at the namespace level. Each tenant has one or multiple namespaces. // 主题的管理单元，用作相关主题的分组机制。大多数主题配置是在命名空间级别执行的。每个租户都有一个或多个命名空间
`topic` `主题`	The final part of the name. Topic names have no special meaning in a Pulsar instance. // 主题名称，在Pulsar实例中没有特殊意义（用户自定义）。

persistent / non-persistent

主题类型

This identifies the type of topic. Pulsar supports two kind of topics: persistent and non-persistent. The default is persistent, so if you do not specify a type, the topic is persistent. With persistent topics, all messages are durably persisted on disks (if the broker is not standalone, messages are durably persisted on multiple disks), whereas data for non-persistent topics is not persisted to storage disks.

// 定义主题的类型。Pulsar支持两种类型主题：持久性和非持久性。默认值是持久的，因此如果不指定类型，则主题是持久的。对于持久主题，所有消息都会持久保存在磁盘上（如果有多个代理，则消息会持久保存在多个磁盘上），而非持久主题的数据不会持久保存到存储磁盘上。

tenant

租户

The topic tenant within the instance. Tenants are essential to multi-tenancy in Pulsar, and spread across clusters.

// 实例中的主题租户。租户分布在集群中，在Pulsar多租户机制中非常重要。

namespace

命名空间

The administrative unit of the topic, which acts as a grouping mechanism for related topics. Most topic configuration is performed at the namespace level. Each tenant has one or multiple namespaces.

// 主题的管理单元，用作相关主题的分组机制。大多数主题配置是在命名空间级别执行的。每个租户都有一个或多个命名空间

topic

主题

The final part of the name. Topic names have no special meaning in a Pulsar instance.

// 主题名称，在Pulsar实例中没有特殊意义（用户自定义）。

无需显式创建新主题

你不需要在 Pulsar 中显式的创建主题。如果客户端尝试向尚未存在的主题写入或接收消息，Pulsar 会自动在主题名称提供的命名空间下创建该主题。如果客户端创建主题时未指定租户或命名空间，则在默认的租户和命名空间下创建该主题。// 使用 Java 客户端 API 并不能自动的创建租户和命名空间

你还可以在指定的租户和命名空间中创建主题，例如：

persistent://my-tenant/my-namespace/my-topic

上述结构表示在 my-tenant 租户下的 my-namespace 命名空间中创建 my-topic 主题。

点击这里了解分区主题、非持久化主题和系统主题。

2、Namespaces（命名空间）

命名空间是租户内的一种逻辑上的命名方式，租户可以通过 admin API 创建多个命名空间。例如，不同应用程序的租户可以为每个应用程序都创建单独的命名空间。命名空间允许应用程序创建和管理主题的层次结构。

比如，主题 my-tenant / app1 定义了一个命名空间，该结构表示 app1 是 my-tenant 租户下的一个命名空间，同时你可以在 app1 名称空间下创建任意数量的主题。

点击回到首页