Skip to content

Commit 3c0a4fc

Browse files
committed
More doc cleanup
1 parent 7cc47fe commit 3c0a4fc

File tree

1 file changed

+3
-1
lines changed
  • docs/technical-details/reference

1 file changed

+3
-1
lines changed

docs/technical-details/reference/blob.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ You can then create a blob which writes the binary data to disk, and can then be
1212
let blob = await createBlob(largeBuffer);
1313
await MyTable.put({ id: 'my-record', data: blob });
1414
```
15-
The `data` attribute in this example is a blob reference, and can be used like any other attribute in the record, but it is stored separately, and the data must be accessed asynchronously. You can retrieve the blob data with the standard Blob methods:
15+
The `data` attribute in this example is a blob reference, and can be used like any other attribute in the record, but it is stored separately, and the data must be accessed asynchronously. You can retrieve the blob data with the standard `Blob` methods:
1616

1717
```javascript
1818
let buffer = await blob.bytes();
@@ -53,6 +53,8 @@ await blob.save(MyTable);
5353
await MyTable.put({ id: 'my-record', data: blob });
5454
```
5555

56+
Note that this means that blobs are _not_ atomic or [ACID](https://en.wikipedia.org/wiki/ACID) compliant; streaming functionality achieves the opposite behavior of ACID/atomic writes that would prevent access to data as it is being written.
57+
5658
### Error Handling
5759
Because blobs can be streamed and referenced prior to their completion, there is a chance that an error or interruption could occur while streaming data to the blob (after the record is committed). We can create an error handler for the blob to handle the case of an interrupted blob:
5860

0 commit comments

Comments
 (0)