You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/cosmos-db/attachments.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,29 +18,29 @@ Azure Cosmos DB attachments are special items that contain references to an asso
18
18
19
19
Azure Cosmos DB supports two types of attachments:
20
20
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.
22
22
***Managed Attachments** are blobs managed and stored internally by Azure Cosmos DB and exposed via a system-generated mediaLink.
23
23
24
24
25
25
> [!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.
27
27
>
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.
29
29
>
30
30
> Microsoft is committed to provide a minimum 36-month notice prior to fully deprecating attachments – which will be announced at a further date.
31
31
32
32
## Known limitations
33
33
34
34
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.
35
35
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.
37
37
- Managed attachments are limited to 2 GB of storage per database account.
38
38
- Managed attachments aren't compatible with Azure Cosmos DB’s global distribution, and they aren't replicated across regions.
39
39
40
40
> [!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.
42
42
>
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.
44
44
45
45
## Migrating Attachments to Azure Blob Storage
46
46
@@ -51,7 +51,7 @@ We recommend migrating Azure Cosmos DB attachments to Azure Blob Storage by foll
51
51
3. If applicable, add URI references to the blobs contained in Azure Blob Storage as string properties within your Azure Cosmos DB dataset.
52
52
4. Refactor your application code to read and write blobs from the new Azure Blob Storage container.
53
53
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.
55
55
56
56
```csharp
57
57
@@ -163,6 +163,6 @@ namespace attachments
163
163
## Next steps
164
164
165
165
- Get started with [Azure Blob storage](../storage/blobs/storage-quickstart-blobs-dotnet.md)
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)
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