This is an automated email from the ASF dual-hosted git repository.
junma 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 2c9c8af899a [improve][doc] Add schema support for python functions
(#486)
2c9c8af899a is described below
commit 2c9c8af899a40c9b68fb8d468c07a2a062d59671
Author: Jun Ma <[email protected]>
AuthorDate: Fri Mar 24 10:54:29 2023 +0800
[improve][doc] Add schema support for python functions (#486)
* add schema type support matrix for language-specific functions
* Update links
---
docs/functions-develop-schema-registry.md | 17 +++++++++++++++--
docs/functions-develop.md | 6 +++---
docs/schema-understand.md | 2 +-
3 files changed, 19 insertions(+), 6 deletions(-)
diff --git a/docs/functions-develop-schema-registry.md
b/docs/functions-develop-schema-registry.md
index dab0505c113..5ca5297bb51 100644
--- a/docs/functions-develop-schema-registry.md
+++ b/docs/functions-develop-schema-registry.md
@@ -4,6 +4,19 @@ title: Use schema registry
sidebar_label: "Use schema registry"
---
-Pulsar has a built-in schema registry and is bundled with popular schema
types, such as Avro, JSON and Protobuf. Pulsar Functions can leverage the
existing schema information from input topics and derive the input type. The
schema registry applies to output topics as well.
+Pulsar has a built-in [schema registry](schema-overview.md) and is bundled
with popular [schema types](schema-understand.md#schema-type). Pulsar Functions
can leverage the existing schema information from input topics and derive the
input type. The schema registry applies to output topics as well.
-For more details, refer to [code
example](https://github.com/apache/pulsar/blob/master/pulsar-functions/java-examples/src/main/java/org/apache/pulsar/functions/api/examples/AutoSchemaFunction.java).
+The following table outlines the supportability of schema types in Pulsar
Functions.
+
+| Schema Type | Java Function | Python Function | Go Function |
+|----------------|---------------|-----------------|-------------|
+| String | ✅ | ✅ | |
+| Avro | ✅ | ✅ | |
+| JSON | ✅ | ✅ | |
+| Protobuf | ✅ | | |
+| ProtobufNative | ✅ | | |
+| Key/Value | ✅ | | |
+| AUTO_PRODUCE | ✅ | | |
+| AUTO_CONSUME | ✅ | | |
+
+For more code examples, see [Java
Functions](https://github.com/apache/pulsar/blob/master/pulsar-functions/java-examples/src/main/java/org/apache/pulsar/functions/api/examples/AutoSchemaFunction.java)
and [Python Functions](
https://github.com/apache/pulsar/blob/master/pulsar-functions/python-examples/).
\ No newline at end of file
diff --git a/docs/functions-develop.md b/docs/functions-develop.md
index 470e26f88a2..e1cf45261fc 100644
--- a/docs/functions-develop.md
+++ b/docs/functions-develop.md
@@ -6,9 +6,9 @@ sidebar_label: "How to develop"
:::note
-Develop functions in Java, Python, or Go.
-* For supported Java versions, refer to [Pulsar runtime Java version
recommendation](https://github.com/apache/pulsar#pulsar-runtime-java-version-recommendation)
for more details.
-* For supported Python versions, refer to [Python
client](client-libraries-python.md) for more details.
+You can develop functions in Java, Python, or Go.
+* For supported Java versions, see [Pulsar runtime Java version
recommendation](https://github.com/apache/pulsar#pulsar-runtime-java-version-recommendation).
+* For supported Python versions, see [Python client
setup](client-libraries-python-setup.md).
:::
diff --git a/docs/schema-understand.md b/docs/schema-understand.md
index cb094228cd2..772779ee926 100644
--- a/docs/schema-understand.md
+++ b/docs/schema-understand.md
@@ -61,7 +61,7 @@ The following table outlines the primitive types that Pulsar
schema supports, an
| `INSTANT`| A single instantaneous point on the timeline with nanoseconds
precision. | java.time.Instant | N/A | N/A | N/A | N/A |
| `LOCAL_DATE` | An immutable date-time object that represents a date, often
viewed as year-month-day. | java.time.LocalDate | N/A | N/A | N/A | N/A |
| `LOCAL_TIME` | An immutable date-time object that represents a time, often
viewed as hour-minute-second. Time is represented to nanosecond precision. |
java.time.LocalDateTime | N/A | N/A | N/A | N/A |
-| LOCAL_DATE_TIME | An immutable date-time object that represents a date-time,
often viewed as year-month-day-hour-minute-second. | java.time.LocalTime | N/A
| N/A | N/A | N/A |
+| `LOCAL_DATE_TIME` | An immutable date-time object that represents a
date-time, often viewed as year-month-day-hour-minute-second. |
java.time.LocalTime | N/A | N/A | N/A | N/A |
:::note
