Edge Storage
Edge Storage allows you to store key-value pairs across our global edge network, providing super-fast, high-volume read capability.
Creating Edge Storage
1. In the CDB Technical Web Portal, navigate to CDB EdgeCompute and choose the relevant page: Edge Storage.
2. In the top-right corner of the screen, click Add Edge Storage.
3. Enter a name for your Edge Storage and provide a description if needed.
4. Click Create Edge Storage. (This completes the Edge Storage creation step)
5. Proceed with inserting key-value pairs.
Inserting KV pairs
1. Add a key-value pair.
Click Insert item and select KV Pair.
In the side panel insert as many KV pairs as you need.
Click + Add value to get another entry row.
2. Upload a value from a file.
Click the Upload Icon to add a value from file. This can be text and/or binary files (e.g. images / fonts etc..)
Info
Uploading values from file has a 1 MB file size limit. Keys are limited to 256 bytes.
Note: File uploads will transform the value in the UI Portal to a hash representation of its content.
3. Add a value with an expiration date.
Click the Expiry Icon to add a value with an expiration date/time.
Info
These values will stop being available in the runtime, after the expiration date. They may remain visible in the UI Portal for longer.
Editing KV pairs
1. In the CDB Technical Web Portal, navigate to CDB EdgeCompute and choose the relevant page: Edge Storage.
2. Find the Edge Storage you want to edit and click its name to open it.
3. Find the key-value pair you want to edit, click the three-dot icon next to the key-value, and select edit.
4. You are now able to edit its value and/or provide an expiration date. If everything is configured correctly, click Save.
Note
You can also insert more key-value pairs from this page. Duplicate keys overwrite the existing value.
Deleting KV pairs
1. In the CDB Technical Web Portal, navigate to CDB EdgeCompute and choose the relevant page: Edge Storage.
2. Find the Edge Storage you want to edit and click its name to open it.
3. Find the key-value pair you want to delete, click the three-dot icon next to the key-value, and select delete.
4. Confirm you want to delete the key-value pair.
Bulk deleting KV pairs
1. In the CDB Technical Web Portal, navigate to CDB EdgeCompute and choose the relevant page: Edge Storage.
2. Find the Edge Storage you want to edit and click its name to open it.
3. Find all the key-value pairs you want to delete, selecting their checkbox in the first column.
4. Click Group actions and select Delete all.
5. Confirm you want to delete all the key-value pairs.
Accessing Edge Storage in applications
For more information regarding Edge Storage usage in applications see the JavaScript SDK and the Rust SDK
Info
In order to use Edge Storage in an application it must first be linked to the application. See Managing Application - Edge Storage
BYOD (Bring Your Own Data)
Edge Storage provides the ability to connect your own external key-value database.
To create a store with your own data:
1. In the CDB Technical Web Portal, navigate to CDB EdgeCompute and choose the relevant page: Edge Storage.
2. In the top-right corner of the screen, click Add Edge Storage.
3. Enter a name for your Edge Storage and provide a description if needed.
4. Check the BYOD checkbox and provide your database connection URL.
Info
During the creation of the Edge Storage the server will attempt to connect to this database. Edge Storage creation will fail if a connection cannot be made.
5. If everything is configured correctly, click Create Edge Storage.
Warning
When creating Edge Storage, you cannot change between BYOD and hosted storage. Once you have created a store it can no longer be updated to change its type.