This is an automated email from the ASF dual-hosted git repository.
urfree pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/pulsar-site.git
The following commit(s) were added to refs/heads/main by this push:
new 3476b58 Docs sync done from apache/pulsar(#9f30ee9)
3476b58 is described below
commit 3476b58f9c9a626f33c4fbdbc7f8f877ebd64574
Author: Pulsar Site Updater <[email protected]>
AuthorDate: Wed Mar 23 06:03:00 2022 +0000
Docs sync done from apache/pulsar(#9f30ee9)
---
site2/docs/client-libraries-cgo.md | 2 ++
site2/docs/client-libraries-go.md | 2 +-
site2/docs/concepts-messaging.md | 10 ++++++----
site2/docs/schema-get-started.md | 2 +-
site2/website-next/docs/client-libraries-cgo.md | 2 ++
site2/website-next/docs/client-libraries-go.md | 2 +-
site2/website-next/docs/concepts-messaging.md | 10 ++++++----
site2/website-next/docs/schema-get-started.md | 2 +-
.../versioned_docs/version-2.2.0/concepts-messaging.md | 10 ++++++----
.../versioned_docs/version-2.2.1/concepts-messaging.md | 10 ++++++----
.../versioned_docs/version-2.3.2/client-libraries-go.md | 2 +-
.../versioned_docs/version-2.4.1/client-libraries-go.md | 2 +-
.../versioned_docs/version-2.4.2/client-libraries-go.md | 2 +-
13 files changed, 35 insertions(+), 23 deletions(-)
diff --git a/site2/docs/client-libraries-cgo.md
b/site2/docs/client-libraries-cgo.md
index 292afb3..1bc187d 100644
--- a/site2/docs/client-libraries-cgo.md
+++ b/site2/docs/client-libraries-cgo.md
@@ -4,6 +4,8 @@ title: Pulsar CGo client
sidebar_label: CGo(deprecated)
---
+> The CGo client has been deprecated since version 2.7.0. If possible, use the
[Go client](client-libraries-go.md) instead.
+
You can use Pulsar Go client to create Pulsar [producers](#producers),
[consumers](#consumers), and [readers](#readers) in Go (aka Golang).
All the methods in [producers](#producers), [consumers](#consumers), and
[readers](#readers) of a Go client are thread-safe.
diff --git a/site2/docs/client-libraries-go.md
b/site2/docs/client-libraries-go.md
index be31491..4158f37 100644
--- a/site2/docs/client-libraries-go.md
+++ b/site2/docs/client-libraries-go.md
@@ -4,7 +4,7 @@ title: Pulsar Go client
sidebar_label: Go
---
-> Tips: Currently, the CGo client will be deprecated, if you want to know more
about the CGo client, please refer to [CGo client docs](client-libraries-cgo.md)
+> Tips: The CGo client has been deprecated since version 2.7.0.
You can use Pulsar [Go client](https://github.com/apache/pulsar-client-go) to
create Pulsar [producers](#producers), [consumers](#consumers), and
[readers](#readers) in Go (aka Golang).
diff --git a/site2/docs/concepts-messaging.md b/site2/docs/concepts-messaging.md
index 9726249..1af731d 100644
--- a/site2/docs/concepts-messaging.md
+++ b/site2/docs/concepts-messaging.md
@@ -20,10 +20,12 @@ Value / data payload | The data carried by the message. All
Pulsar messages cont
Key | Messages are optionally tagged with keys, which is useful for things
like [topic compaction](concepts-topic-compaction.md).
Properties | An optional key/value map of user-defined properties.
Producer name | The name of the producer who produces the message. If you do
not specify a producer name, the default name is used.
-Sequence ID | Each Pulsar message belongs to an ordered sequence on its topic.
The sequence ID of the message is its order in that sequence.
+Topic name | The name of the topic that the message is published to.
+Schema version | The version number of the schema that the message is produced
with.
+Sequence ID | Each Pulsar message belongs to an ordered sequence on its topic.
The sequence ID of a message is initially assigned by its producer, indicating
its order in that sequence, and can also be customized.<br />Sequence ID can be
used for message deduplication. If `brokerDeduplicationEnabled` is set to
`true`, the sequence ID of each message is unique within a producer of a topic
(non-partitioned) or a partition.
+Message ID | The message ID of a message is assigned by bookies as soon as the
message is persistently stored. Message ID indicates a message’s specific
position in a ledger and is unique within a Pulsar cluster.
Publish time | The timestamp of when the message is published. The timestamp
is automatically applied by the producer.
Event time | An optional timestamp attached to a message by applications. For
example, applications attach a timestamp on when the message is processed. If
nothing is set to event time, the value is `0`.
-TypedMessageBuilder | It is used to construct a message. You can set message
properties such as the message key, message value with `TypedMessageBuilder`.
</br> When you set `TypedMessageBuilder`, set the key as a string. If you set
the key as other types, for example, an AVRO object, the key is sent as bytes,
and it is difficult to get the AVRO object back on the consumer.
The default size of a message is 5 MB. You can configure the max size of a
message with the following configurations.
@@ -554,8 +556,8 @@ The subscription mode indicates the cursor type.
Subscription mode | Description | Note
|---|---|---
-`Durable`|The cursor is durable, which retains messages and persists the
current position. <br></br>If a broker restarts from a failure, it can recover
the cursor from the persistent storage (BookKeeper), so that messages can
continue to be consumed from the last consumed position.|`Durable` is the
**default** subscription mode.
-`NonDurable`|The cursor is non-durable. <br></br>Once a broker stops, the
cursor is lost and can never be recovered, so that messages **can not**
continue to be consumed from the last consumed position.|Reader’s subscription
mode is `NonDurable` in nature and it does not prevent data in a topic from
being deleted. Reader’s subscription mode **can not** be changed.
+`Durable`|The cursor is durable, which retains messages and persists the
current position. <br />If a broker restarts from a failure, it can recover the
cursor from the persistent storage (BookKeeper), so that messages can continue
to be consumed from the last consumed position.|`Durable` is the **default**
subscription mode.
+`NonDurable`|The cursor is non-durable. <br />Once a broker stops, the cursor
is lost and can never be recovered, so that messages **can not** continue to be
consumed from the last consumed position.|Reader’s subscription mode is
`NonDurable` in nature and it does not prevent data in a topic from being
deleted. Reader’s subscription mode **can not** be changed.
A [subscription](#concepts-messaging.md/#subscriptions) can have one or more
consumers. When a consumer subscribes to a topic, it must specify the
subscription name. A durable subscription and a non-durable subscription can
have the same name, they are independent of each other. If a consumer specifies
a subscription which does not exist before, the subscription is automatically
created.
diff --git a/site2/docs/schema-get-started.md b/site2/docs/schema-get-started.md
index bee1bd5..7db45bd 100644
--- a/site2/docs/schema-get-started.md
+++ b/site2/docs/schema-get-started.md
@@ -16,7 +16,7 @@ Applications typically adopt one of the following approaches
to guarantee type s
#### Note
>
-> Currently, the Pulsar schema registry is only available for the [Java
client](client-libraries-java.md), [CGo client](client-libraries-cgo.md),
[Python client](client-libraries-python.md), and [C++
client](client-libraries-cpp.md).
+> Currently, the Pulsar schema registry is only available for the [Java
client](client-libraries-java.md), [Go client](client-libraries-go.md), [Python
client](client-libraries-python.md), and [C++ client](client-libraries-cpp.md).
### Client-side approach
diff --git a/site2/website-next/docs/client-libraries-cgo.md
b/site2/website-next/docs/client-libraries-cgo.md
index dc1ee95..e6ee21b 100644
--- a/site2/website-next/docs/client-libraries-cgo.md
+++ b/site2/website-next/docs/client-libraries-cgo.md
@@ -4,6 +4,8 @@ title: Pulsar CGo client
sidebar_label: "CGo(deprecated)"
---
+> The CGo client has been deprecated since version 2.7.0. If possible, use the
[Go client](client-libraries-go) instead.
+
You can use Pulsar Go client to create Pulsar [producers](#producers),
[consumers](#consumers), and [readers](#readers) in Go (aka Golang).
All the methods in [producers](#producers), [consumers](#consumers), and
[readers](#readers) of a Go client are thread-safe.
diff --git a/site2/website-next/docs/client-libraries-go.md
b/site2/website-next/docs/client-libraries-go.md
index 6a0922c..c6200c1 100644
--- a/site2/website-next/docs/client-libraries-go.md
+++ b/site2/website-next/docs/client-libraries-go.md
@@ -4,7 +4,7 @@ title: Pulsar Go client
sidebar_label: "Go"
---
-> Tips: Currently, the CGo client will be deprecated, if you want to know more
about the CGo client, please refer to [CGo client docs](client-libraries-cgo)
+> Tips: The CGo client has been deprecated since version 2.7.0.
You can use Pulsar [Go client](https://github.com/apache/pulsar-client-go) to
create Pulsar [producers](#producers), [consumers](#consumers), and
[readers](#readers) in Go (aka Golang).
diff --git a/site2/website-next/docs/concepts-messaging.md
b/site2/website-next/docs/concepts-messaging.md
index 8f542db..1e088ef 100644
--- a/site2/website-next/docs/concepts-messaging.md
+++ b/site2/website-next/docs/concepts-messaging.md
@@ -26,10 +26,12 @@ Value / data payload | The data carried by the message. All
Pulsar messages cont
Key | Messages are optionally tagged with keys, which is useful for things
like [topic compaction](concepts-topic-compaction).
Properties | An optional key/value map of user-defined properties.
Producer name | The name of the producer who produces the message. If you do
not specify a producer name, the default name is used.
-Sequence ID | Each Pulsar message belongs to an ordered sequence on its topic.
The sequence ID of the message is its order in that sequence.
+Topic name | The name of the topic that the message is published to.
+Schema version | The version number of the schema that the message is produced
with.
+Sequence ID | Each Pulsar message belongs to an ordered sequence on its topic.
The sequence ID of a message is initially assigned by its producer, indicating
its order in that sequence, and can also be customized.<br />Sequence ID can be
used for message deduplication. If `brokerDeduplicationEnabled` is set to
`true`, the sequence ID of each message is unique within a producer of a topic
(non-partitioned) or a partition.
+Message ID | The message ID of a message is assigned by bookies as soon as the
message is persistently stored. Message ID indicates a message’s specific
position in a ledger and is unique within a Pulsar cluster.
Publish time | The timestamp of when the message is published. The timestamp
is automatically applied by the producer.
Event time | An optional timestamp attached to a message by applications. For
example, applications attach a timestamp on when the message is processed. If
nothing is set to event time, the value is `0`.
-TypedMessageBuilder | It is used to construct a message. You can set message
properties such as the message key, message value with `TypedMessageBuilder`.
<br /> When you set `TypedMessageBuilder`, set the key as a string. If you set
the key as other types, for example, an AVRO object, the key is sent as bytes,
and it is difficult to get the AVRO object back on the consumer.
The default size of a message is 5 MB. You can configure the max size of a
message with the following configurations.
@@ -647,8 +649,8 @@ The subscription mode indicates the cursor type.
Subscription mode | Description | Note
|---|---|---
-`Durable`|The cursor is durable, which retains messages and persists the
current position. <br /><br />If a broker restarts from a failure, it can
recover the cursor from the persistent storage (BookKeeper), so that messages
can continue to be consumed from the last consumed position.|`Durable` is the
**default** subscription mode.
-`NonDurable`|The cursor is non-durable. <br /><br />Once a broker stops, the
cursor is lost and can never be recovered, so that messages **can not**
continue to be consumed from the last consumed position.|Reader’s subscription
mode is `NonDurable` in nature and it does not prevent data in a topic from
being deleted. Reader’s subscription mode **can not** be changed.
+`Durable`|The cursor is durable, which retains messages and persists the
current position. <br />If a broker restarts from a failure, it can recover the
cursor from the persistent storage (BookKeeper), so that messages can continue
to be consumed from the last consumed position.|`Durable` is the **default**
subscription mode.
+`NonDurable`|The cursor is non-durable. <br />Once a broker stops, the cursor
is lost and can never be recovered, so that messages **can not** continue to be
consumed from the last consumed position.|Reader’s subscription mode is
`NonDurable` in nature and it does not prevent data in a topic from being
deleted. Reader’s subscription mode **can not** be changed.
A [subscription](#concepts-messaging.md/#subscriptions) can have one or more
consumers. When a consumer subscribes to a topic, it must specify the
subscription name. A durable subscription and a non-durable subscription can
have the same name, they are independent of each other. If a consumer specifies
a subscription which does not exist before, the subscription is automatically
created.
diff --git a/site2/website-next/docs/schema-get-started.md
b/site2/website-next/docs/schema-get-started.md
index 6736b44..99401b9 100644
--- a/site2/website-next/docs/schema-get-started.md
+++ b/site2/website-next/docs/schema-get-started.md
@@ -16,7 +16,7 @@ Applications typically adopt one of the following approaches
to guarantee type s
#### Note
>
-> Currently, the Pulsar schema registry is only available for the [Java
client](client-libraries-java.md), [CGo client](client-libraries-cgo.md),
[Python client](client-libraries-python.md), and [C++
client](client-libraries-cpp).
+> Currently, the Pulsar schema registry is only available for the [Java
client](client-libraries-java.md), [Go client](client-libraries-go.md), [Python
client](client-libraries-python.md), and [C++ client](client-libraries-cpp).
### Client-side approach
diff --git
a/site2/website-next/versioned_docs/version-2.2.0/concepts-messaging.md
b/site2/website-next/versioned_docs/version-2.2.0/concepts-messaging.md
index 8f542db..1e088ef 100644
--- a/site2/website-next/versioned_docs/version-2.2.0/concepts-messaging.md
+++ b/site2/website-next/versioned_docs/version-2.2.0/concepts-messaging.md
@@ -26,10 +26,12 @@ Value / data payload | The data carried by the message. All
Pulsar messages cont
Key | Messages are optionally tagged with keys, which is useful for things
like [topic compaction](concepts-topic-compaction).
Properties | An optional key/value map of user-defined properties.
Producer name | The name of the producer who produces the message. If you do
not specify a producer name, the default name is used.
-Sequence ID | Each Pulsar message belongs to an ordered sequence on its topic.
The sequence ID of the message is its order in that sequence.
+Topic name | The name of the topic that the message is published to.
+Schema version | The version number of the schema that the message is produced
with.
+Sequence ID | Each Pulsar message belongs to an ordered sequence on its topic.
The sequence ID of a message is initially assigned by its producer, indicating
its order in that sequence, and can also be customized.<br />Sequence ID can be
used for message deduplication. If `brokerDeduplicationEnabled` is set to
`true`, the sequence ID of each message is unique within a producer of a topic
(non-partitioned) or a partition.
+Message ID | The message ID of a message is assigned by bookies as soon as the
message is persistently stored. Message ID indicates a message’s specific
position in a ledger and is unique within a Pulsar cluster.
Publish time | The timestamp of when the message is published. The timestamp
is automatically applied by the producer.
Event time | An optional timestamp attached to a message by applications. For
example, applications attach a timestamp on when the message is processed. If
nothing is set to event time, the value is `0`.
-TypedMessageBuilder | It is used to construct a message. You can set message
properties such as the message key, message value with `TypedMessageBuilder`.
<br /> When you set `TypedMessageBuilder`, set the key as a string. If you set
the key as other types, for example, an AVRO object, the key is sent as bytes,
and it is difficult to get the AVRO object back on the consumer.
The default size of a message is 5 MB. You can configure the max size of a
message with the following configurations.
@@ -647,8 +649,8 @@ The subscription mode indicates the cursor type.
Subscription mode | Description | Note
|---|---|---
-`Durable`|The cursor is durable, which retains messages and persists the
current position. <br /><br />If a broker restarts from a failure, it can
recover the cursor from the persistent storage (BookKeeper), so that messages
can continue to be consumed from the last consumed position.|`Durable` is the
**default** subscription mode.
-`NonDurable`|The cursor is non-durable. <br /><br />Once a broker stops, the
cursor is lost and can never be recovered, so that messages **can not**
continue to be consumed from the last consumed position.|Reader’s subscription
mode is `NonDurable` in nature and it does not prevent data in a topic from
being deleted. Reader’s subscription mode **can not** be changed.
+`Durable`|The cursor is durable, which retains messages and persists the
current position. <br />If a broker restarts from a failure, it can recover the
cursor from the persistent storage (BookKeeper), so that messages can continue
to be consumed from the last consumed position.|`Durable` is the **default**
subscription mode.
+`NonDurable`|The cursor is non-durable. <br />Once a broker stops, the cursor
is lost and can never be recovered, so that messages **can not** continue to be
consumed from the last consumed position.|Reader’s subscription mode is
`NonDurable` in nature and it does not prevent data in a topic from being
deleted. Reader’s subscription mode **can not** be changed.
A [subscription](#concepts-messaging.md/#subscriptions) can have one or more
consumers. When a consumer subscribes to a topic, it must specify the
subscription name. A durable subscription and a non-durable subscription can
have the same name, they are independent of each other. If a consumer specifies
a subscription which does not exist before, the subscription is automatically
created.
diff --git
a/site2/website-next/versioned_docs/version-2.2.1/concepts-messaging.md
b/site2/website-next/versioned_docs/version-2.2.1/concepts-messaging.md
index 8f542db..1e088ef 100644
--- a/site2/website-next/versioned_docs/version-2.2.1/concepts-messaging.md
+++ b/site2/website-next/versioned_docs/version-2.2.1/concepts-messaging.md
@@ -26,10 +26,12 @@ Value / data payload | The data carried by the message. All
Pulsar messages cont
Key | Messages are optionally tagged with keys, which is useful for things
like [topic compaction](concepts-topic-compaction).
Properties | An optional key/value map of user-defined properties.
Producer name | The name of the producer who produces the message. If you do
not specify a producer name, the default name is used.
-Sequence ID | Each Pulsar message belongs to an ordered sequence on its topic.
The sequence ID of the message is its order in that sequence.
+Topic name | The name of the topic that the message is published to.
+Schema version | The version number of the schema that the message is produced
with.
+Sequence ID | Each Pulsar message belongs to an ordered sequence on its topic.
The sequence ID of a message is initially assigned by its producer, indicating
its order in that sequence, and can also be customized.<br />Sequence ID can be
used for message deduplication. If `brokerDeduplicationEnabled` is set to
`true`, the sequence ID of each message is unique within a producer of a topic
(non-partitioned) or a partition.
+Message ID | The message ID of a message is assigned by bookies as soon as the
message is persistently stored. Message ID indicates a message’s specific
position in a ledger and is unique within a Pulsar cluster.
Publish time | The timestamp of when the message is published. The timestamp
is automatically applied by the producer.
Event time | An optional timestamp attached to a message by applications. For
example, applications attach a timestamp on when the message is processed. If
nothing is set to event time, the value is `0`.
-TypedMessageBuilder | It is used to construct a message. You can set message
properties such as the message key, message value with `TypedMessageBuilder`.
<br /> When you set `TypedMessageBuilder`, set the key as a string. If you set
the key as other types, for example, an AVRO object, the key is sent as bytes,
and it is difficult to get the AVRO object back on the consumer.
The default size of a message is 5 MB. You can configure the max size of a
message with the following configurations.
@@ -647,8 +649,8 @@ The subscription mode indicates the cursor type.
Subscription mode | Description | Note
|---|---|---
-`Durable`|The cursor is durable, which retains messages and persists the
current position. <br /><br />If a broker restarts from a failure, it can
recover the cursor from the persistent storage (BookKeeper), so that messages
can continue to be consumed from the last consumed position.|`Durable` is the
**default** subscription mode.
-`NonDurable`|The cursor is non-durable. <br /><br />Once a broker stops, the
cursor is lost and can never be recovered, so that messages **can not**
continue to be consumed from the last consumed position.|Reader’s subscription
mode is `NonDurable` in nature and it does not prevent data in a topic from
being deleted. Reader’s subscription mode **can not** be changed.
+`Durable`|The cursor is durable, which retains messages and persists the
current position. <br />If a broker restarts from a failure, it can recover the
cursor from the persistent storage (BookKeeper), so that messages can continue
to be consumed from the last consumed position.|`Durable` is the **default**
subscription mode.
+`NonDurable`|The cursor is non-durable. <br />Once a broker stops, the cursor
is lost and can never be recovered, so that messages **can not** continue to be
consumed from the last consumed position.|Reader’s subscription mode is
`NonDurable` in nature and it does not prevent data in a topic from being
deleted. Reader’s subscription mode **can not** be changed.
A [subscription](#concepts-messaging.md/#subscriptions) can have one or more
consumers. When a consumer subscribes to a topic, it must specify the
subscription name. A durable subscription and a non-durable subscription can
have the same name, they are independent of each other. If a consumer specifies
a subscription which does not exist before, the subscription is automatically
created.
diff --git
a/site2/website-next/versioned_docs/version-2.3.2/client-libraries-go.md
b/site2/website-next/versioned_docs/version-2.3.2/client-libraries-go.md
index 6a0922c..c6200c1 100644
--- a/site2/website-next/versioned_docs/version-2.3.2/client-libraries-go.md
+++ b/site2/website-next/versioned_docs/version-2.3.2/client-libraries-go.md
@@ -4,7 +4,7 @@ title: Pulsar Go client
sidebar_label: "Go"
---
-> Tips: Currently, the CGo client will be deprecated, if you want to know more
about the CGo client, please refer to [CGo client docs](client-libraries-cgo)
+> Tips: The CGo client has been deprecated since version 2.7.0.
You can use Pulsar [Go client](https://github.com/apache/pulsar-client-go) to
create Pulsar [producers](#producers), [consumers](#consumers), and
[readers](#readers) in Go (aka Golang).
diff --git
a/site2/website-next/versioned_docs/version-2.4.1/client-libraries-go.md
b/site2/website-next/versioned_docs/version-2.4.1/client-libraries-go.md
index 6a0922c..c6200c1 100644
--- a/site2/website-next/versioned_docs/version-2.4.1/client-libraries-go.md
+++ b/site2/website-next/versioned_docs/version-2.4.1/client-libraries-go.md
@@ -4,7 +4,7 @@ title: Pulsar Go client
sidebar_label: "Go"
---
-> Tips: Currently, the CGo client will be deprecated, if you want to know more
about the CGo client, please refer to [CGo client docs](client-libraries-cgo)
+> Tips: The CGo client has been deprecated since version 2.7.0.
You can use Pulsar [Go client](https://github.com/apache/pulsar-client-go) to
create Pulsar [producers](#producers), [consumers](#consumers), and
[readers](#readers) in Go (aka Golang).
diff --git
a/site2/website-next/versioned_docs/version-2.4.2/client-libraries-go.md
b/site2/website-next/versioned_docs/version-2.4.2/client-libraries-go.md
index 6a0922c..c6200c1 100644
--- a/site2/website-next/versioned_docs/version-2.4.2/client-libraries-go.md
+++ b/site2/website-next/versioned_docs/version-2.4.2/client-libraries-go.md
@@ -4,7 +4,7 @@ title: Pulsar Go client
sidebar_label: "Go"
---
-> Tips: Currently, the CGo client will be deprecated, if you want to know more
about the CGo client, please refer to [CGo client docs](client-libraries-cgo)
+> Tips: The CGo client has been deprecated since version 2.7.0.
You can use Pulsar [Go client](https://github.com/apache/pulsar-client-go) to
create Pulsar [producers](#producers), [consumers](#consumers), and
[readers](#readers) in Go (aka Golang).
