無需解凍直接即時讀取歸檔檔案 - Object Storage Service

歸檔直讀功能允許您在資料湖、雲相簿等情境中直接存取Archive Storage類型檔案，無需提前解凍，在保持低儲存成本的同時實現對極低頻訪問資料的即時讀取，平衡了儲存成本與訪問效率的需求。

解凍讀取和直接讀取

開啟歸檔直讀的前後對比如下：

專案	未開啟歸檔直讀（預設）	開啟歸檔直讀
取回方式	先解凍，再讀取	直接讀取
取回費用^①	低	高
取回時間	分鐘級	毫秒級

^①關於取回費用的具體價格，請參見OSS產品定價。

開啟歸檔直讀

OSS控制台

登入OSS管理主控台。
單擊Bucket 列表，然後單擊目標Bucket名稱。
在左側導覽列，選擇資料管理 > 歸檔直讀。
在歸檔直讀頁面，開啟歸檔直讀。
在提示對話方塊，單擊確定。

命令列工具ossutil

使用前需安裝ossutil。

以下命令用於為儲存空間examplebucket開啟歸檔直讀。
```
ossutil api put-bucket-archive-direct-read --bucket examplebucket --archive-direct-read-configuration "{\"Enabled\":\"true\"}"
```
關於該命令的更多資訊，請參見put-bucket-archive-direct-read。
以下命令用於查看儲存空間examplebucket是否開啟歸檔直讀。
```
ossutil api get-bucket-archive-direct-read --bucket examplebucket
```
關於該命令的更多資訊，請參見get-bucket-archive-direct-read。

API

如果您的程式自訂要求較高，您可以直接發起REST API請求。直接發起REST API請求需要手動編寫代碼計算簽名。更多資訊，請參見PutBucketArchiveDirectRead和GetBucketArchiveDirectRead。

涉及讀取的操作

開啟歸檔直讀後，無需解凍Bucket中的Archive Storage類型檔案，就可以直接對其進行以下涉及讀取的操作：

查詢通過歸檔直讀產生的Object訪問記錄

未在Log Service開啟archive_direct_read_size欄位索引，使用掃描模式查詢：

* and __topic__: oss_access_log and bucket: buckename | set session mode=scan; select object where archive_direct_read_size not like '-'

已在Log Service開啟archive_direct_read_size欄位索引，使用索引模式查詢：

* and __topic__: oss_access_log and bucket: buckename |select object where archive_direct_read_size not like '-'

查詢通過歸檔直讀產生的流量大小

未在Log Service開啟archive_direct_read_size欄位索引，使用掃描模式查詢：

* and __topic__: oss_access_log and bucket: bucketname | set session mode=scan; select sum(cast(archive_direct_read_size as bigint)) as total_size where archive_direct_read_size != '-'

已在Log Service開啟archive_direct_read_size欄位索引，使用索引模式查詢：

* and __topic__: oss_access_log and bucket: bucketname | select sum(cast(archive_direct_read_size as bigint)) as total_size where archive_direct_read_size != '-'

許可權說明

RAM使用者必須有以下許可權：oss:PutBucketArchiveDirectRead、oss:GetBucketArchiveDirectRead。具體操作，請參見為RAM使用者授予自訂的權限原則。

使用限制

歸檔直讀僅適用於Bucket中Archive Storage類型的檔案，不適用於冷歸檔、深度冷Archive Storage類型的檔案。
在Bucket開啟歸檔直讀的情況下，如果在配置靜態網站託管時將預設首頁或錯誤版面設定為同一Bucket內未解凍的歸檔類型檔案，則跳轉訪問預設首頁或錯誤頁面失敗，並返回403錯誤。為確保可以正常跳轉訪問，預設首頁和錯誤頁面建議配置為標準儲存類型的檔案。

費用說明

為Bucket開啟歸檔直讀後，直接讀取Bucket中未解凍的Archive Storage類型檔案，會產生歸檔直讀資料取回容量（RetrievalDataArchiveDirect）費用，請求產生的歸檔直讀取回容量通過日誌欄位archive_direct_read_size的值來表示。對於已解凍的Archive Storage類型檔案，直接讀取不會產生歸檔直讀資料取回容量費用。詳情請參見資料處理費用。
歸檔直讀資料取回量取決於與HTTP建立串連時要求標頭中指定的資料讀取範圍。傳輸串連的提前斷開不會影響已發起請求的歸檔直讀資料取回容量。例如，實際讀取1位元組資料後中斷串連，但是請求範圍為100 MB~200 MB，將按照100 MB~200 MB計算歸檔直讀資料取回容量。
通過歸檔直讀功能對儲存的歸檔類型圖片執行圖片縮放操作，OSS將按照原圖大小，而非處理後的圖片大小作為歸檔直讀取回容量。這意味著，即便原圖經過處理後顯著減小了其傳輸時的實際佔用頻寬，您仍需根據原圖大小支付歸檔直讀取迴流量費用。例如，原圖大小為1 GB，經圖片縮放處理後僅為100 KB，歸檔直讀資料取回計費容量為1 GB。