如果您希望從Bucket存儲的海量Object中快速查找與指定的Object名稱、ETag、存儲類型、大小、最后修改時間等條件匹配的Object，您可以使用數據索引功能。通過數據索引功能，您可以在查找目標Object時指定過濾條件，對查詢結果按需選擇排序和聚合的方式，提升查找目標Object的效率。
注意事項
僅Python SDK 2.16.0及以上版本支持使用數據索引功能。
僅華東1（杭州）地域的Bucket支持使用數據索引功能。無地域屬性的Bucket不支持使用數據索引功能。更多信息，請參見數據索引。
本文以華東1（杭州）外網Endpoint為例。如果您希望通過與OSS同地域的其他阿里云產品訪問OSS，請使用內網Endpoint。關于OSS支持的Region與Endpoint的對應關系，請參見OSS地域和訪問域名。
本文以從環境變量讀取訪問憑證為例。如何配置訪問憑證，請參見配置訪問憑證。
本文以OSS域名新建OSSClient為例。如果您希望通過自定義域名、STS等方式新建OSSClient，請參見初始化。
開啟元數據管理功能
以下代碼用于為Bucket開啟元數據管理功能。開啟后，OSS會為Bucket創建元數據索引庫并為Bucket中的所有Object建立元數據索引。元數據索引庫創建完成后，OSS會繼續對Bucket中新增文件進行準實時的增量追蹤掃描并為增量文件建立元數據索引。
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# 從環境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# 填寫Bucket所在地域對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 填寫Endpoint對應的Region信息，例如cn-hangzhou。注意，v4簽名下，必須填寫該參數
region = "cn-hangzhou"
# examplebucket填寫存儲空間名稱。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
# 開啟元數據管理功能。
bucket.open_bucket_meta_query()獲取元數據索引庫信息
以下代碼用于獲取指定Bucket的元數據索引庫信息。
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# 從環境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# 填寫Bucket所在地域對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 填寫Endpoint對應的Region信息，例如cn-hangzhou。注意，v4簽名下，必須填寫該參數
region = "cn-hangzhou"
# examplebucket填寫存儲空間名稱。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
# 獲取指定Bucket的元數據索引庫信息。
get_result = bucket.get_bucket_meta_query_status()
# 打印狀態。
print(get_result.state)查詢滿足指定條件的Object
以下代碼用于查詢滿足指定條件Object，并按照指定字段和排序方式列出Object信息。
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
from oss2.models import MetaQuery, AggregationsRequest
# 從環境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# 填寫Bucket所在地域對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 填寫Endpoint對應的Region信息，例如cn-hangzhou。注意，v4簽名下，必須填寫該參數
region = "cn-hangzhou"
# examplebucket填寫存儲空間名稱。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
# 查詢滿足指定條件的Object，并按照指定字段和排序方式列舉Object信息。
# 指定查詢小于1 MB的文件，且最多返回十個結果，返回結果按升序排列。
do_meta_query_request = MetaQuery(max_results=10, query='{"Field": "Size","Value": "1048576","Operation": "lt"}', sort='Size', order='asc')
result = bucket.do_bucket_meta_query(do_meta_query_request)
# 打印Object名稱。
print(result.files[0].file_name)
# 打印Object對應的ETag。
print(result.files[0].etag)
# 打印Object類型。
print(result.files[0].oss_object_type)
# 打印Object存儲類型。
print(result.files[0].oss_storage_class)
# 打印Object的64位CRC值。
print(result.files[0].oss_crc64)
# 打印Object的訪問權限。
print(result.files[0].object_acl)關閉元數據管理功能
以下代碼用于關閉指定Bucket的元數據索引功能。
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# 從環境變量中獲取訪問憑證。運行本代碼示例之前，請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# 填寫Bucket所在地域對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 填寫Endpoint對應的Region信息，例如cn-hangzhou。注意，v4簽名下，必須填寫該參數
region = "cn-hangzhou"
# examplebucket填寫存儲空間名稱。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
# 關閉指定Bucket的元數據管理功能。
bucket.close_bucket_meta_query()相關文檔
關于開啟元數據管理功能的API接口說明，請參見OpenMetaQuery。
關于獲取元數據索引庫信息的API接口說明，請參見GetMetaQueryStatus。
關于查詢滿足指定條件的Object，并按照指定字段和排序方式列出Object信息的API接口說明，請參見DoMetaQuery。
關于關閉元數據管理功能的API接口說明，請參見CloseMetaQuery。