diff --git a/cloud/operations/export-import.md b/cloud/operations/export-import.md new file mode 100644 index 00000000..2fb02de3 --- /dev/null +++ b/cloud/operations/export-import.md @@ -0,0 +1,138 @@ +--- +title: "Export and Import" +parent: "Cloud Operations" +nav_order: 1 +description: "Export and import a FalkorDB Cloud instance using RDB. Export to a download link, Google Cloud Storage, or Amazon S3. Import from a file, URL, cloud storage, or another instance. Schedule recurring exports on Pro and Enterprise." +--- + +# Export and Import + +FalkorDB Cloud lets you export and import an instance from the **Import/Export RDB** tab on the instance page. An export writes an RDB file of your data. An import loads an RDB into your instance. RDB is the binary snapshot format used by FalkorDB. + +![The Import/Export RDB tab with the task list and the Export RDB, Import RDB, and Schedules buttons](/images/cloud/export-import/import-export-tab.png) + +## Before you begin + +- The instance must be in the **Running** state. +- Your access depends on your subscription role. Export needs the **root**, **editor**, or **reader** role. Import needs the **root** or **editor** role. +- One export or import task runs at a time per instance. A new request while another task is in progress is rejected. +- When you use your own cloud storage, the access credentials are used only to reach your bucket for that task. They are not stored on the task record. + +## Export + +An export writes a copy of your instance data to a destination you choose. + +1. Open the **Import/Export RDB** tab on your instance. +2. Select **Export RDB**. +3. Choose a destination and fill in the details. +4. Select **Export**. + +The task appears in the list. When it completes you can track it under **Output**. + +### Temporary link + +FalkorDB writes the export to managed storage and generates a download link. The link is valid for **one hour**. + +![Export RDB dialog with Temporary link selected](/images/cloud/export-import/export-temporary-link.png) + +When the task completes, select **Download** in the **Output** column to retrieve the file. + +![Task list showing a completed export with a Download link](/images/cloud/export-import/export-task-download.png) + +### Google Cloud Storage + +FalkorDB writes the export to your own Google Cloud Storage bucket. Provide the bucket name and a GCP service account key with permission to create objects in that bucket. + +![Export RDB dialog with Google Cloud Storage selected](/images/cloud/export-import/export-google-cloud-storage.png) + +### Amazon S3 + +FalkorDB writes the export to your own Amazon S3 bucket. Provide the bucket name, region, and AWS access credentials with permission to create objects in that bucket. A session token is optional. + +![Export RDB dialog with Amazon S3 selected](/images/cloud/export-import/export-amazon-s3.png) + +## Import + +An import loads an RDB into your instance. + +> **Caution.** The instance is erased before the import takes place. FalkorDB takes a safety copy of the current data before clearing it, and verifies the imported key count after the load. + +1. Open the **Import/Export RDB** tab on your instance. +2. Select **Import RDB**. +3. Choose a source and fill in the details. +4. Select **Import**. + +### Upload a file + +Upload an RDB file from your local machine. + +![Import RDB dialog with Upload file selected and the erase caution](/images/cloud/export-import/import-upload-file.png) + +### URL + +Provide a public HTTPS URL to the RDB file. The URL must use HTTPS and must not point to a private or internal address. FalkorDB checks that the file is reachable before it starts. + +### Google Cloud Storage + +Read the RDB from your own Google Cloud Storage bucket. Provide the bucket name, the RDB file path, and a GCP service account key with permission to read objects from that bucket. + +![Import RDB dialog with Google Cloud Storage selected](/images/cloud/export-import/import-google-cloud-storage.png) + +### Amazon S3 + +Read the RDB from your own Amazon S3 bucket. Provide the bucket name, the RDB file path, the region, and AWS access credentials with permission to read objects from that bucket. A session token is optional. + +![Import RDB dialog with Amazon S3 selected](/images/cloud/export-import/import-amazon-s3.png) + +### Another instance + +Clone the data from another running FalkorDB Cloud instance. FalkorDB checks that the source data fits the destination before it starts. + +## Scheduled exports + +Scheduled exports are available on the **Pro** and **Enterprise** tiers. On lower tiers the **Schedules** button is disabled. + +Open **Schedules** from the **Import/Export RDB** tab to create and manage them. + +- Set how often the export runs. The period is at least **60 minutes** and a multiple of 15. +- Set the minute of the hour the export starts. The choices are **0, 15, 30, or 45**. +- You can keep up to **2 schedules** per instance. +- A schedule is disabled automatically after **3 consecutive failures**. + +A scheduled export supports the same destinations as a one off export. A scheduled import clones from another instance. + +## Task history + +The task list on the **Import/Export RDB** tab shows your past exports and imports. Each row shows the task type, the source or destination, the status, the timestamps, and the output. Statuses move from **created** to **pending**, **in_progress**, and then **completed** or **failed**. + +## Limits + +| Item | Value | +| :--- | :--- | +| Concurrent tasks per instance | 1 | +| Instance state required | Running | +| Scheduled exports | Pro and Enterprise only | +| Schedules per instance | Up to 2 | +| Schedule period | 60 minutes or more, multiple of 15 | +| Schedule start minute | 0, 15, 30, or 45 | +| Temporary download link validity | 1 hour | +| Upload link validity | 1 hour | +| Import size | Must fit the destination capacity | + +## Getting Support + +Questions about an export or import? Email **[support@falkordb.com](mailto:support@falkordb.com)**. See the [Support page](/support/) for what to include in your request. + +{% include faq_accordion.html + title="Frequently Asked Questions" + q1="How is an export different from a snapshot or an automatic backup?" + a1="An export is an **RDB file you create or schedule**, sent to a download link or your own cloud storage. Automatic backups and snapshots are taken by the platform and are managed separately. See your tier page for those policies." + q2="Does an import overwrite my current data?" + a2="Yes. The instance is **erased before the import**. FalkorDB takes a safety copy of the current data before clearing it, then verifies the imported key count after the load." + q3="Which destinations and sources are supported?" + a3="Export goes to a **temporary download link**, **Google Cloud Storage**, or **Amazon S3**. Import reads from an **uploaded file**, a **URL**, **Google Cloud Storage**, **Amazon S3**, or **another instance**." + q4="Can I schedule exports on any tier?" + a4="Scheduled exports are available on the **Pro** and **Enterprise** tiers. On lower tiers the Schedules button is disabled." + q5="Are my cloud storage credentials stored?" + a5="No. Credentials you enter for your own bucket are used only to reach that bucket for the task. They are not kept on the task record." +%} diff --git a/cloud/operations/index.md b/cloud/operations/index.md new file mode 100644 index 00000000..704cb60d --- /dev/null +++ b/cloud/operations/index.md @@ -0,0 +1,15 @@ +--- +title: "Cloud Operations" +parent: "Cloud DBaaS" +nav_order: 7 +has_children: true +description: "Operational guides for FalkorDB Cloud, including RDB export and import for your managed graph database." +--- + +# Cloud Operations + +Operational guides for running your FalkorDB Cloud deployment. These guides cover day to day tasks you perform from the FalkorDB Cloud console. + +## [Export and Import](/cloud/operations/export-import) + +Export your instance to a download link or your own cloud storage. Import from a file, a URL, your cloud storage, or another instance. Schedule recurring exports on Pro and Enterprise. diff --git a/images/cloud/export-import/export-amazon-s3.png b/images/cloud/export-import/export-amazon-s3.png new file mode 100644 index 00000000..21ff2cab Binary files /dev/null and b/images/cloud/export-import/export-amazon-s3.png differ diff --git a/images/cloud/export-import/export-google-cloud-storage.png b/images/cloud/export-import/export-google-cloud-storage.png new file mode 100644 index 00000000..9ec330f6 Binary files /dev/null and b/images/cloud/export-import/export-google-cloud-storage.png differ diff --git a/images/cloud/export-import/export-task-download.png b/images/cloud/export-import/export-task-download.png new file mode 100644 index 00000000..1de93399 Binary files /dev/null and b/images/cloud/export-import/export-task-download.png differ diff --git a/images/cloud/export-import/export-temporary-link.png b/images/cloud/export-import/export-temporary-link.png new file mode 100644 index 00000000..ad4311e1 Binary files /dev/null and b/images/cloud/export-import/export-temporary-link.png differ diff --git a/images/cloud/export-import/import-amazon-s3.png b/images/cloud/export-import/import-amazon-s3.png new file mode 100644 index 00000000..d0b47855 Binary files /dev/null and b/images/cloud/export-import/import-amazon-s3.png differ diff --git a/images/cloud/export-import/import-export-tab.png b/images/cloud/export-import/import-export-tab.png new file mode 100644 index 00000000..aaeb025c Binary files /dev/null and b/images/cloud/export-import/import-export-tab.png differ diff --git a/images/cloud/export-import/import-google-cloud-storage.png b/images/cloud/export-import/import-google-cloud-storage.png new file mode 100644 index 00000000..77cc1da3 Binary files /dev/null and b/images/cloud/export-import/import-google-cloud-storage.png differ diff --git a/images/cloud/export-import/import-upload-file.png b/images/cloud/export-import/import-upload-file.png new file mode 100644 index 00000000..3313ff48 Binary files /dev/null and b/images/cloud/export-import/import-upload-file.png differ