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
@@ -103,6 +103,13 @@ The below table shows all the valid operators for FindBlobsByTags:
103
103
| AND | Logical and | "Rank" >= '010' AND "Rank" < '100' |
104
104
|@container| Scope to a specific container |@container = 'videofiles' AND "status" = 'done' |
105
105
106
+
> [!NOTE]
107
+
> Be familiar with lexicographical ordering when setting and querying on tags.
108
+
> - Numbers are sorted before letters. Numbers are sorted based on the first digit.
109
+
> - Uppercase letters are sorted before lowercase letters.
110
+
> - Symbols are not standard. Some symbols are sorted before numeric values. Other symbols are sorted before or after letters.
111
+
>
112
+
106
113
## Conditional Blob operations with Blob Index tags
107
114
In REST versions 2019-10-10 and higher, most [blob service APIs](https://docs.microsoft.com/rest/api/storageservices/operations-on-blobs) now support a conditional header, x-ms-if-tags, such that the operation will only succeed if the specified blob index condition is met. If the condition is not met, you will get `error 412: The condition specified using HTTP conditional header(s) is not met`.
108
115
@@ -243,9 +250,11 @@ Blob Index pricing is currently in public preview and subject to change for gene
243
250
244
251
## Regional availability and storage account support
245
252
246
-
Blob Index is currently available with General Purpose v2 (GPv2) accounts only. In the Azure portal, you can upgrade an existing General Purpose (GPv1) account to a GPv2 account. For more information about storage accounts, see [Azure storage account overview](../common/storage-account-overview.md).
253
+
Blob Index is currently only available on General Purpose v2 (GPv2) accounts with hierarchical namespace (HNS) disabled. General Purpose (GPV1) accounts are not supported but you can upgrade any GPv1 account to a GPv2 account. For more information about storage accounts, see [Azure storage account overview](../common/storage-account-overview.md).
247
254
248
255
In public preview, Blob Index is currently only available in the following select regions:
256
+
- Canada Central
257
+
- Canada East
249
258
- France Central
250
259
- France South
251
260
@@ -273,7 +282,7 @@ az provider register --namespace 'Microsoft.Storage'
273
282
This section describes known issues and conditions in the current public preview of the Blob Index. As with most previews, this feature should not be used for production workloads until it reaches GA as behaviors may change.
274
283
275
284
- For preview, you must first register your subscription before you can use Blob Index for your storage account in the preview regions.
276
-
- Only GPv2 accounts are currently supported in preview. Blob, BlockBlobStorage, and HNS enabled DataLake Gen2 accounts are not currently supported with Blob Index.
285
+
- Only GPv2 accounts are currently supported in preview. Blob, BlockBlobStorage, and HNS enabled DataLake Gen2 accounts are not currently supported with Blob Index. GPv1 accounts will not be supported.
277
286
- Uploading page blobs with index tags currently does not persist the tags. You must set the tags after uploading a page blob.
278
287
- When filtering is scoped to a single container, the @container can only be passed if all the index tags in the filter expression are equality checks (key=value).
279
288
- When using the range operator with the AND condition, you can only specify the same index tag key name (Age > ‘013’ AND Age < ‘100’).
@@ -288,6 +297,9 @@ This section describes known issues and conditions in the current public preview
288
297
### Can Blob Index help me filter and query content inside my blobs?
289
298
No, Blob Index tags can help you find the blobs that you are looking for. If you need to search within your blobs, use Query Acceleration or Azure Search.
290
299
300
+
### Are there any special considerations regarding Blob Index tag values?
301
+
Blob Index tags only support string data types and querying returns results with lexicographical ordering. For numbers, it is recommended to zero pad the number. For date and times, it is recommended to store as an ISO 8601 compliant format.
302
+
291
303
### Are Blob Index tags and Azure Resource Manager tags related?
292
304
No, Azure Resource Manager tags help organize control plane resources such as subscriptions, resource groups, and storage accounts. Blob Index tags provide object management and discovery on data plane resources such as blobs within a storage account.
0 commit comments