Merge branch 'v1.13' into issue_3704

This commit is contained in:
Mark Fussell 2024-03-01 15:19:54 -08:00 committed by GitHub
commit cf4a0c2ce1
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 32 additions and 1 deletions

View File

@ -146,6 +146,36 @@ If an invocation of the method fails, the timer is not removed. Timers are only
- The executions run out - The executions run out
- You delete it explicitly - You delete it explicitly
## Reminder data serialization format
Actor reminder data is serialized to JSON by default. Dapr v1.13 onwards supports a protobuf serialization format for reminders data which, depending on throughput and size of the payload, can result in significant performance improvements, giving developers a higher throughput and lower latency. Another benefit is storing smaller data in the actor underlying database, which can result in cost optimizations when using some cloud databases. A restriction with using protobuf serialization is that the reminder data can no longer be queried.
{{% alert title="Note" color="primary" %}}
Protobuf serialization will become the default format in Dapr 1.14
{{% /alert %}}
Reminder data saved in protobuf format cannot be read in Dapr 1.12.x and earlier versions. Its recommended to test this feature in Dapr v1.13 and verify that it works as expected with your database before taking this into production.
{{% alert title="Note" color="primary" %}}
If you use protobuf serialization in Dapr v1.13 and need to downgrade to an earlier Dapr version, the reminder data will be incompatible with versions 1.12.x and earlier versions. **Once you save your reminders data in protobuf format, you cannot move it back to JSON format**.
{{% /alert %}}
### Enabling protobuf serialization on Kubernetes
To use protobuf serialization for actor reminders on Kubernetes, use the following Helm value:
```
--set dapr_placement.maxActorApiLevel=20
```
### Enabling protobuf serialization on self-hosted
To use protobuf serialization for actor reminders on self-hosted, use the following `daprd` flag:
```
--max-api-level=20
```
## Next steps ## Next steps
{{< button text="Configure actor runtime behavior >>" page="actors-runtime-config.md" >}} {{< button text="Configure actor runtime behavior >>" page="actors-runtime-config.md" >}}
@ -153,4 +183,4 @@ If an invocation of the method fails, the timer is not removed. Timers are only
## Related links ## Related links
- [Actors API reference]({{< ref actors_api.md >}}) - [Actors API reference]({{< ref actors_api.md >}})
- [Actors overview]({{< ref actors-overview.md >}}) - [Actors overview]({{< ref actors-overview.md >}})

View File

@ -89,6 +89,7 @@ The above example uses secrets as plain strings. It is recommended to use a [sec
| processMode | N | Enable processing multiple messages at once. Default: `"async"` | `"async"`, `"sync"`| | processMode | N | Enable processing multiple messages at once. Default: `"async"` | `"async"`, `"sync"`|
| subscribeType | N | Pulsar supports four kinds of [subscription types](https://pulsar.apache.org/docs/3.0.x/concepts-messaging/#subscription-types). Default: `"shared"` | `"shared"`, `"exclusive"`, `"failover"`, `"key_shared"`| | subscribeType | N | Pulsar supports four kinds of [subscription types](https://pulsar.apache.org/docs/3.0.x/concepts-messaging/#subscription-types). Default: `"shared"` | `"shared"`, `"exclusive"`, `"failover"`, `"key_shared"`|
| partitionKey | N | Sets the key of the message for routing policy. Default: `""` | | | partitionKey | N | Sets the key of the message for routing policy. Default: `""` | |
| `maxConcurrentHandlers` | N | Defines the maximum number of concurrent message handlers. Default: `100` | `10`
### Authenticate using Token ### Authenticate using Token