Skip to content

Commit b1bbafe

Browse files
Merge pull request #214116 from FabianMeiswinkel/users/fabianm/idCharDoc
Azure Cosmos Concept-and-limits:Add context on character limitations for ID
2 parents 0ccc857 + c61ba1b commit b1bbafe

File tree

1 file changed

+2
-1
lines changed

1 file changed

+2
-1
lines changed

articles/cosmos-db/concepts-limits.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ You can provision throughput at a container-level or a database-level in terms o
3434
| Maximum storage per container | Unlimited |
3535
| Maximum attachment size per Account (Attachment feature is being deprecated) | 2 GB |
3636
| Minimum RU/s required per 1 GB | 10 RU/s <sup>3</sup> |
37-
37+
3838
<sup>1</sup> You can increase Maximum RUs per container or database by [filing an Azure support ticket](create-support-request-quota-increase.md).
3939

4040
<sup>2</sup> To learn about best practices for managing workloads that have partition keys requiring higher limits for storage or throughput, see [Create a synthetic partition key](synthetic-partition-keys.md). If your workload has already reached the logical partition limit of 20 GB in production, it's recommended to rearchitect your application with a different partition key as a long-term solution. To help give time to rearchitect your application, you can request a temporary increase in the logical partition key limit for your existing application. [File an Azure support ticket](create-support-request-quota-increase.md) and select quota type **Temporary increase in container's logical partition key size**. Requesting a temporary increase is intended as a temporary mitigation and not recommended as a long-term solution, as **SLA guarantees are not honored when the limit is increased**. To remove the configuration, file a support ticket and select quota type **Restore container’s logical partition key size to default (20 GB)**. Filing this support ticket can be done after you have either deleted data to fit the 20-GB logical partition limit or have rearchitected your application with a different partition key.
@@ -158,6 +158,7 @@ An Azure Cosmos DB item can represent either a document in a collection, a row i
158158
| Maximum size of an item | 2 MB (UTF-8 length of JSON representation) <sup>1</sup> |
159159
| Maximum length of partition key value | 2048 bytes |
160160
| Maximum length of ID value | 1023 bytes |
161+
| Allowed characters for ID value | Service-side all Unicode characters except for '/' and '\\' are allowed. <br/>**WARNING: But for best interoperability we STRONGLY RECOMMEND to only use alpha-numerical ASCII characters in the ID value only**. <br/>There are several known limitations in some versions of the Cosmos DB SDK, as well as connectors (ADF, Spark, Kafka etc.) and http-drivers/libraries etc. that can prevent successful processing when the ID value contains non-alphanumerical ASCII characters. So, to increase interoperability, please encode the ID value - [for example via Base64 + custom encoding of special charatcers allowed in Base64](https://github.com/Azure/azure-cosmos-dotnet-v3/blob/78fc16c35c521b4f9a7aeef11db4df79c2545dee/Microsoft.Azure.Cosmos.Encryption/src/EncryptionProcessor.cs#L475-L489). - if you have to support non-alphanumerical ASCII characters in your service/application. |
161162
| Maximum number of properties per item | No practical limit |
162163
| Maximum length of property name | No practical limit |
163164
| Maximum length of property value | No practical limit |

0 commit comments

Comments
 (0)