Skip to content

Commit dd7ec28

Browse files
authored
Merge pull request #102669 from catslovedata/patch-2
Fixed some typos and applied minor formatting changes
2 parents b856f4b + 1d1f9e2 commit dd7ec28

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

articles/cosmos-db/attachments.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -18,29 +18,29 @@ Azure Cosmos DB attachments are special items that contain references to an asso
1818

1919
Azure Cosmos DB supports two types of attachments:
2020

21-
* **Unmanaged Attachments** are a wrapper around an URI reference to a blob that is stored in an external service (for example, Azure Storage, OneDrive, etc.). This approach is similar to storing a URI property in a standard Azure Cosmos DB item.
21+
* **Unmanaged Attachments** are a wrapper around a URI reference to a blob that is stored in an external service (for example, Azure Storage, OneDrive, etc.). This approach is similar to storing a URI property in a standard Azure Cosmos DB item.
2222
* **Managed Attachments** are blobs managed and stored internally by Azure Cosmos DB and exposed via a system-generated mediaLink.
2323

2424

2525
> [!NOTE]
26-
> Attachment is a legacy feature. Their support is scoped to offer continued functionality if you are already using this feature.
26+
> Attachments are a legacy feature. Their support is scoped to offer continued functionality if you are already using this feature.
2727
>
28-
> Instead of using attachments, we recommend you to use Azure Blob Storage as a purpose-built blob storage service to store blob data . You can continue to store metadata related to blobs, along with reference URI links, in Azure Cosmos DB as item properties. Storing this data in Azure Cosmos DB provides the ability to query metadata and links to blobs stored in Azure Blob Storage.
28+
> Instead of using attachments, we recommend you to use Azure Blob Storage as a purpose-built blob storage service to store blob data. You can continue to store metadata related to blobs, along with reference URI links, in Azure Cosmos DB as item properties. Storing this data in Azure Cosmos DB provides the ability to query metadata and links to blobs stored in Azure Blob Storage.
2929
>
3030
> Microsoft is committed to provide a minimum 36-month notice prior to fully deprecating attachments – which will be announced at a further date.
3131
3232
## Known limitations
3333

3434
Azure Cosmos DB’s managed attachments are distinct from its support for standard items – for which it offers unlimited scalability, global distribution, and integration with other Azure services.
3535

36-
- Attachments aren't supported in all versions of the Azure Cosmos DB’s SDKs.
36+
- Attachments aren't supported in all versions of the Azure Cosmos DB SDKs.
3737
- Managed attachments are limited to 2 GB of storage per database account.
3838
- Managed attachments aren't compatible with Azure Cosmos DB’s global distribution, and they aren't replicated across regions.
3939

4040
> [!NOTE]
41-
> Azure Cosmso DB for MongoDB version 3.2 utilizes managed attachments for GridFS and are subject to the same limitations.
41+
> Azure Cosmos DB for MongoDB version 3.2 utilizes managed attachments for GridFS and these are subject to the same limitations.
4242
>
43-
> We recommend developers using the MongoDB GridFS feature set to upgrade to Azure Cosmso DB for MongoDB version 3.6 or higher, which is decoupled from attachments and provides a better experience. Alternatively, developers using the MongoDB GridFS feature set should also consider using Azure Blob Storage - which is purpose-built for storing blob content and offers expanded functionality at lower cost compared to GridFS.
43+
> We recommend developers using the MongoDB GridFS feature set to upgrade to Azure Cosmos DB for MongoDB version 3.6 or higher, which is decoupled from attachments and provides a better experience. Alternatively, developers using the MongoDB GridFS feature set should also consider using Azure Blob Storage - which is purpose-built for storing blob content and offers expanded functionality at lower cost compared to GridFS.
4444
4545
## Migrating Attachments to Azure Blob Storage
4646

@@ -51,7 +51,7 @@ We recommend migrating Azure Cosmos DB attachments to Azure Blob Storage by foll
5151
3. If applicable, add URI references to the blobs contained in Azure Blob Storage as string properties within your Azure Cosmos DB dataset.
5252
4. Refactor your application code to read and write blobs from the new Azure Blob Storage container.
5353

54-
The following dotnet code sample shows how to copy attachments from Azure Cosmos DB to Azure Blob storage as part of a migration flow by using Azure Cosmos DB's .NET SDK v2 and Azure Blob Storage .NET SDK v12. Make sure to replace the `<placeholder values>` for the source Azure Cosmos DB account and target Azure Blob storage container.
54+
The following code sample shows how to copy attachments from Azure Cosmos DB to Azure Blob storage as part of a migration flow by using Azure Cosmos DB's .NET SDK v2 and Azure Blob Storage .NET SDK v12. Make sure to replace the `<placeholder values>` for the source Azure Cosmos DB account and target Azure Blob storage container.
5555

5656
```csharp
5757

@@ -163,6 +163,6 @@ namespace attachments
163163
## Next steps
164164

165165
- Get started with [Azure Blob storage](../storage/blobs/storage-quickstart-blobs-dotnet.md)
166-
- Get references for using attachments via [Azure Cosmos DBs .NET SDK v2](/dotnet/api/microsoft.azure.documents.attachment)
167-
- Get references for using attachments via [Azure Cosmos DBs Java SDK v2](/java/api/com.microsoft.azure.documentdb.attachment)
168-
- Get references for using attachments via [Azure Cosmos DBs REST API](/rest/api/cosmos-db/attachments)
166+
- Get references for using attachments via [Azure Cosmos DB's .NET SDK v2](/dotnet/api/microsoft.azure.documents.attachment)
167+
- Get references for using attachments via [Azure Cosmos DB's Java SDK v2](/java/api/com.microsoft.azure.documentdb.attachment)
168+
- Get references for using attachments via [Azure Cosmos DB's REST API](/rest/api/cosmos-db/attachments)

0 commit comments

Comments
 (0)