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 55f8b40e6199 Docs sync done from apache/pulsar (#b9ededc)
55f8b40e6199 is described below
commit 55f8b40e61995a07b55e2eaa33e37ef655609c00
Author: github-actions[bot]
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Sat Oct 5 01:35:27 2024 +0000
Docs sync done from apache/pulsar (#b9ededc)
---
.../next/config/reference-configuration-broker.md | 22 ++++
.../config/reference-configuration-standalone.md | 22 ++++
static/reference/next/pulsar-admin/schemas.md | 118 +++++++++++++++++++++
static/swagger/master/swagger.json | 84 +++++++++++++++
static/swagger/master/v2/swagger.json | 84 +++++++++++++++
5 files changed, 330 insertions(+)
diff --git a/static/reference/next/config/reference-configuration-broker.md
b/static/reference/next/config/reference-configuration-broker.md
index f6e16d072f2e..e1d757cd1d32 100644
--- a/static/reference/next/config/reference-configuration-broker.md
+++ b/static/reference/next/config/reference-configuration-broker.md
@@ -5032,6 +5032,17 @@ Default is `CRC32C`. Other possible options are `CRC32`,
`MAC` or `DUMMY` (no ch
**Category**: Storage (Managed Ledger)
+### managedLedgerForceRecovery
+Skip managed ledger failure to forcefully recover managed ledger.
+
+**Type**: `boolean`
+
+**Default**: `false`
+
+**Dynamic**: `true`
+
+**Category**: Storage (Managed Ledger)
+
### managedLedgerInactiveLedgerRolloverTimeSeconds
Time to rollover ledger for inactive topic (duration without any publish on
that topic). Disable rollover with value 0 (Default value 0)
@@ -5332,6 +5343,17 @@ If enabled, the maximum "acknowledgment holes" will not
be limited and "acknowle
**Category**: Storage (Managed Ledger)
+### schemaLedgerForceRecovery
+Skip schema ledger failure to forcefully recover topic successfully.
+
+**Type**: `boolean`
+
+**Default**: `false`
+
+**Dynamic**: `true`
+
+**Category**: Storage (Managed Ledger)
+
### brokerClientSslFactoryPlugin
SSL Factory Plugin class used by internal client to provide SSLEngine and
SSLContext objects. The default class used is DefaultSslFactory.
diff --git a/static/reference/next/config/reference-configuration-standalone.md
b/static/reference/next/config/reference-configuration-standalone.md
index f6e16d072f2e..e1d757cd1d32 100644
--- a/static/reference/next/config/reference-configuration-standalone.md
+++ b/static/reference/next/config/reference-configuration-standalone.md
@@ -5032,6 +5032,17 @@ Default is `CRC32C`. Other possible options are `CRC32`,
`MAC` or `DUMMY` (no ch
**Category**: Storage (Managed Ledger)
+### managedLedgerForceRecovery
+Skip managed ledger failure to forcefully recover managed ledger.
+
+**Type**: `boolean`
+
+**Default**: `false`
+
+**Dynamic**: `true`
+
+**Category**: Storage (Managed Ledger)
+
### managedLedgerInactiveLedgerRolloverTimeSeconds
Time to rollover ledger for inactive topic (duration without any publish on
that topic). Disable rollover with value 0 (Default value 0)
@@ -5332,6 +5343,17 @@ If enabled, the maximum "acknowledgment holes" will not
be limited and "acknowle
**Category**: Storage (Managed Ledger)
+### schemaLedgerForceRecovery
+Skip schema ledger failure to forcefully recover topic successfully.
+
+**Type**: `boolean`
+
+**Default**: `false`
+
+**Dynamic**: `true`
+
+**Category**: Storage (Managed Ledger)
+
### brokerClientSslFactoryPlugin
SSL Factory Plugin class used by internal client to provide SSLEngine and
SSLContext objects. The default class used is DefaultSslFactory.
diff --git a/static/reference/next/pulsar-admin/schemas.md
b/static/reference/next/pulsar-admin/schemas.md
index feccc5f3d658..045962d31bc9 100644
--- a/static/reference/next/pulsar-admin/schemas.md
+++ b/static/reference/next/pulsar-admin/schemas.md
@@ -301,6 +301,124 @@ $ pulsar-admin schemas extract options
| `[-v, --version]` | Print version information and exit.|null||
+## metadata
+
+Get the schema for a topic
+
+**Command:**
+
+```shell
+$ pulsar-admin schemas metadata options
+```
+
+**Options:**
+
+|Flag|Description|Default|
+|---|---|---|
+| `[-h, --help]` | Show this help message and exit.|null||
+| `[-v, --version]` | Print version information and exit.|null||
+
+# schemas
+
+Operations about schemas
+
+
+```shell
+$ pulsar-admin schemas subcommand
+```
+
+
+
+## get
+
+Get the schema for a topic
+
+**Command:**
+
+```shell
+$ pulsar-admin schemas get options
+```
+
+**Options:**
+
+|Flag|Description|Default|
+|---|---|---|
+| `[-h, --help]` | Show this help message and exit.|null||
+| `[-v, --version]` | Print version information and exit.|null||
+
+
+## delete
+
+Delete all versions schema of a topic
+
+**Command:**
+
+```shell
+$ pulsar-admin schemas delete options
+```
+
+**Options:**
+
+|Flag|Description|Default|
+|---|---|---|
+| `[-h, --help]` | Show this help message and exit.|null||
+| `[-v, --version]` | Print version information and exit.|null||
+
+
+## upload
+
+Update the schema for a topic
+
+**Command:**
+
+```shell
+$ pulsar-admin schemas upload options
+```
+
+**Options:**
+
+|Flag|Description|Default|
+|---|---|---|
+| `[-h, --help]` | Show this help message and exit.|null||
+| `[-v, --version]` | Print version information and exit.|null||
+
+
+## extract
+
+Provide the schema via a topic
+
+**Command:**
+
+```shell
+$ pulsar-admin schemas extract options
+```
+
+**Options:**
+
+|Flag|Description|Default|
+|---|---|---|
+| `[-h, --help]` | Show this help message and exit.|null||
+| `[-v, --version]` | Print version information and exit.|null||
+
+
+## metadata
+
+Get the schema for a topic
+
+**Command:**
+
+```shell
+$ pulsar-admin schemas metadata options
+```
+
+**Options:**
+
+|Flag|Description|Default|
+|---|---|---|
+| `[-h, --help]` | Show this help message and exit.|null||
+| `[-v, --version]` | Print version information and exit.|null||
+
+
## compatibility
Test schema compatibility
diff --git a/static/swagger/master/swagger.json
b/static/swagger/master/swagger.json
index 1cc9a5c53781..17883d655d14 100644
--- a/static/swagger/master/swagger.json
+++ b/static/swagger/master/swagger.json
@@ -710,6 +710,24 @@
},
"type": "object"
},
+ "CompletableFutureSchemaMetadata": {
+ "properties": {
+ "cancelled": {
+ "type": "boolean"
+ },
+ "completedExceptionally": {
+ "type": "boolean"
+ },
+ "done": {
+ "type": "boolean"
+ },
+ "numberOfDependents": {
+ "format": "int32",
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
"CompletableFutureSchemaVersion": {
"properties": {
"cancelled": {
@@ -34923,6 +34941,72 @@
]
}
},
+ "/schemas/{tenant}/{namespace}/{topic}/metadata": {
+ "get": {
+ "description": "",
+ "operationId": "SchemasResource_getSchemaMetadata",
+ "parameters": [
+ {
+ "in": "path",
+ "name": "tenant",
+ "required": true,
+ "type": "string"
+ },
+ {
+ "in": "path",
+ "name": "namespace",
+ "required": true,
+ "type": "string"
+ },
+ {
+ "in": "path",
+ "name": "topic",
+ "required": true,
+ "type": "string"
+ },
+ {
+ "default": false,
+ "in": "query",
+ "name": "authoritative",
+ "required": false,
+ "type": "boolean"
+ }
+ ],
+ "produces": [
+ "application/json"
+ ],
+ "responses": {
+ "200": {
+ "description": "successful operation",
+ "schema": {
+ "$ref":
"#/definitions/GetAllVersionsSchemaResponse"
+ }
+ },
+ "307": {
+ "description": "Current broker doesn't serve the
namespace of this topic"
+ },
+ "401": {
+ "description": "Client is not authorized or Don't have
admin permission"
+ },
+ "403": {
+ "description": "Client is not authenticated"
+ },
+ "404": {
+ "description": "Tenant or Namespace or Topic doesn't
exist; or Schema is not found for this topic"
+ },
+ "412": {
+ "description": "Failed to find the ownership for the
topic"
+ },
+ "500": {
+ "description": "Internal Server Error"
+ }
+ },
+ "summary": "Get the schema metadata of a topic",
+ "tags": [
+ "schemas"
+ ]
+ }
+ },
"/schemas/{tenant}/{namespace}/{topic}/schema": {
"delete": {
"description": "",
diff --git a/static/swagger/master/v2/swagger.json
b/static/swagger/master/v2/swagger.json
index 1cc9a5c53781..17883d655d14 100644
--- a/static/swagger/master/v2/swagger.json
+++ b/static/swagger/master/v2/swagger.json
@@ -710,6 +710,24 @@
},
"type": "object"
},
+ "CompletableFutureSchemaMetadata": {
+ "properties": {
+ "cancelled": {
+ "type": "boolean"
+ },
+ "completedExceptionally": {
+ "type": "boolean"
+ },
+ "done": {
+ "type": "boolean"
+ },
+ "numberOfDependents": {
+ "format": "int32",
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
"CompletableFutureSchemaVersion": {
"properties": {
"cancelled": {
@@ -34923,6 +34941,72 @@
]
}
},
+ "/schemas/{tenant}/{namespace}/{topic}/metadata": {
+ "get": {
+ "description": "",
+ "operationId": "SchemasResource_getSchemaMetadata",
+ "parameters": [
+ {
+ "in": "path",
+ "name": "tenant",
+ "required": true,
+ "type": "string"
+ },
+ {
+ "in": "path",
+ "name": "namespace",
+ "required": true,
+ "type": "string"
+ },
+ {
+ "in": "path",
+ "name": "topic",
+ "required": true,
+ "type": "string"
+ },
+ {
+ "default": false,
+ "in": "query",
+ "name": "authoritative",
+ "required": false,
+ "type": "boolean"
+ }
+ ],
+ "produces": [
+ "application/json"
+ ],
+ "responses": {
+ "200": {
+ "description": "successful operation",
+ "schema": {
+ "$ref":
"#/definitions/GetAllVersionsSchemaResponse"
+ }
+ },
+ "307": {
+ "description": "Current broker doesn't serve the
namespace of this topic"
+ },
+ "401": {
+ "description": "Client is not authorized or Don't have
admin permission"
+ },
+ "403": {
+ "description": "Client is not authenticated"
+ },
+ "404": {
+ "description": "Tenant or Namespace or Topic doesn't
exist; or Schema is not found for this topic"
+ },
+ "412": {
+ "description": "Failed to find the ownership for the
topic"
+ },
+ "500": {
+ "description": "Internal Server Error"
+ }
+ },
+ "summary": "Get the schema metadata of a topic",
+ "tags": [
+ "schemas"
+ ]
+ }
+ },
"/schemas/{tenant}/{namespace}/{topic}/schema": {
"delete": {
"description": "",
