Fetches a fragment of a blob up to MAX_BLOB_FETCH_SIZE in length. Attempting
to fetch a fragment that extends beyond the boundaries of the blob will return
the amount of data from start_index until the end of the blob, which will be
a smaller size than requested. Requesting a fragment that is entirely outside
the boundaries of the blob will return an empty string. Attempting to fetch a
negative index will raise an exception.
Args
blob
A BlobInfo, BlobKey, string, or Unicode representation of
the BlobKey of the blob from which you want to fetch data.
start_index
The start index of blob data to fetch. This value must not be
negative.
end_index
The end index (inclusive) of the blob data to fetch. This value
must be greater than or equal to start_index.
rpc
Optional UserRPC object.
Returns
A string that contains partial data of a blob. If the indexes are legal but
outside of the boundaries of the blob, an empty string is returned.
Raises
TypeError
If start_index or end_index are not indexes, or if blob is
not a string, BlobKey or BlobInfo.
DataIndexOutOfRangeError
If start_index is set to a value that is less
than 0 or end_index is less than start_index.
BlobFetchSizeTooLargeError
If the requested blob fragment is larger than
MAX_BLOB_FETCH_SIZE.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2022-09-30 UTC."],[[["The `fetch_data` function retrieves a specific portion of data from a blob, limited by `MAX_BLOB_FETCH_SIZE`."],["You can specify the desired fragment of the blob using `start_index` and `end_index`, and any request outside of a blob's boundaries will result in the function returning an empty string."],["The function accepts the `blob` as a `BlobInfo`, `BlobKey`, string, or Unicode representation of the `BlobKey`."],["The function will raise errors like `TypeError`, `DataIndexOutOfRangeError`, `BlobFetchSizeTooLargeError`, or `BlobNotFoundError` if there are problems with the inputs or if the blob does not exist."],["The function `fetch_data` returns a string that contains partial data of a blob, or an empty string if indexes are legal but outside the blob's boundaries."]]],[]]
View source on GitHub