mirror of https://github.com/dapr/docs.git
Merge branch 'v1.13' into issue_3704
This commit is contained in:
commit
cf4a0c2ce1
|
@ -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 >}})
|
||||||
|
|
|
@ -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
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue