mirror of
https://github.com/supabase/supabase.git
synced 2026-10-17 15:19:08 +03:00
Merge branch 'master' of github.com:supabase/supabase
This commit is contained in:
commit
83cf1426f7
4 files changed
+104
No files matched your search
@@ -1861,6 +1861,12 @@ export const MIGRATION_PAGES: Partial<NavMenuSection & ComponentProps<typeof Ico
|
||||
url: '/guides/platform/migrating-to-supabase/vercel-postgres',
|
||||
hasLightIcon: true,
|
||||
},
|
||||
{
|
||||
name: 'Neon',
|
||||
icon: '/docs/img/icons/neon-icon',
|
||||
url: '/guides/platform/migrating-to-supabase/neon',
|
||||
hasLightIcon: true,
|
||||
},
|
||||
{
|
||||
name: 'MySQL',
|
||||
icon: '/docs/img/icons/mysql-icon',
|
||||
|
||||
@@ -0,0 +1,90 @@
|
||||
---
|
||||
title: 'Migrate from Neon to Supabase'
|
||||
description: 'Migrate your existing Neon database to Supabase.'
|
||||
subtitle: 'Migrate your existing Neon database to Supabase.'
|
||||
---
|
||||
|
||||
This guide demonstrates how to migrate your Neon database to Supabase to get the most out of Postgres while gaining access to all the features you need to build a project.
|
||||
|
||||
## Retrieve your Neon database credentials [#retrieve-credentials]
|
||||
|
||||
1. Log in to your Neon Console [https://console.neon.tech/login](https://console.neon.tech/login).
|
||||
1. Select **Projects** on the left.
|
||||
1. Click on your project in the list.
|
||||
1. From your Project Dashboard find your **Connection string** and click **Copy snippet** to copy it to the clipboard (do not check "pooled connection").
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
postgresql://neondb_owner:xxxxxxxxxxxxxxx-random-word-yyyyyyyy.us-west-2.aws.neon.tech/neondb?sslmode=require
|
||||
```
|
||||
|
||||
## Set your OLD_DB_URL environment variable
|
||||
|
||||
Set the **OLD_DB_URL** environment variable at the command line using your Neon database credentials from the clipboard.
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
export OLD_DB_URL="postgresql://neondb_owner:xxxxxxxxxxxxxxx-random-word-yyyyyyyy.us-west-2.aws.neon.tech/neondb?sslmode=require"
|
||||
```
|
||||
|
||||
## Retrieve your Supabase connection string [#retrieve-supabase-connection-string]
|
||||
|
||||
1. If you're new to Supabase, [create a project](https://supabase.com/dashboard).
|
||||
Make a note of your password, you will need this later. If you forget it, you can [reset it here](https://supabase.com/dashboard/project/_/settings/database).
|
||||
|
||||
1. Go to the [Database settings](https://supabase.com/dashboard/project/_/settings/database) for your project in the Supabase Dashboard.
|
||||
1. Under **Connection string**, select **URI**, make sure **Display connection pooler** is checked, and **Mode: Session** is set.
|
||||
1. Click the **Copy** button to the right of your connection string to copy it to the clipboard.
|
||||
|
||||
## Set your NEW_DB_URL environment variable
|
||||
|
||||
Set the **NEW_DB_URL** environment variable at the command line using your Supabase connection string. You will need to replace `[YOUR-PASSWORD]` with your actual database password.
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
export NEW_DB_URL="postgresql://postgres.xxxxxxxxxxxxxxxxxxxx:[YOUR-PASSWORD]@aws-0-us-west-1.pooler.supabase.com:5432/postgres"
|
||||
```
|
||||
|
||||
## Migrate the database
|
||||
|
||||
You will need the [pg_dump](https://www.postgresql.org/docs/current/app-pgdump.html) and [psql](https://www.postgresql.org/docs/current/app-psql.html) command line tools, which are included in a full [PostgreSQL installation](https://www.postgresql.org/download).
|
||||
|
||||
1. Export your database to a file in console
|
||||
|
||||
Use `pg_dump` with your Postgres credentials to export your database to a file (e.g., `dump.sql`).
|
||||
|
||||
```bash
|
||||
pg_dump "$OLD_DB_URL" \
|
||||
--clean \
|
||||
--if-exists \
|
||||
--quote-all-identifiers \
|
||||
--no-owner \
|
||||
--no-privileges \
|
||||
> dump.sql
|
||||
```
|
||||
|
||||
2. Import the database to your Supabase project
|
||||
|
||||
Use `psql` to import the Postgres database file to your Supabase project.
|
||||
|
||||
```bash
|
||||
psql -d "$NEW_DB_URL" -f dump.sql
|
||||
```
|
||||
|
||||
Additional options
|
||||
|
||||
- To only migrate a single database schema, add the `--schema=PATTERN` parameter to your `pg_dump` command.
|
||||
- To exclude a schema: `--exclude-schema=PATTERN`.
|
||||
- To only migrate a single table: `--table=PATTERN`.
|
||||
- To exclude a table: `--exclude-table=PATTERN`.
|
||||
|
||||
Run `pg_dump --help` for a full list of options.
|
||||
|
||||
<MigrationWarnings />
|
||||
|
||||
## Enterprise
|
||||
|
||||
[Contact us](https://forms.supabase.com/enterprise) if you need more help migrating your project.
|
||||
@@ -0,0 +1,4 @@
|
||||
<svg width="58" height="57" viewBox="0 0 58 57" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<path fill-rule="evenodd" clip-rule="evenodd" d="M0 9.82759C0 4.39996 4.47705 0 9.99976 0H47.9989C53.5216 0 57.9986 4.39996 57.9986 9.82759V41.5893C57.9986 47.2045 50.7684 49.6414 47.2618 45.2082L36.2991 31.3488V48.1552C36.2991 53.04 32.2698 57 27.2993 57H9.99976C4.47705 57 0 52.6 0 47.1724V9.82759ZM9.99976 7.86207C8.89522 7.86207 7.99981 8.74206 7.99981 9.82759V47.1724C7.99981 48.2579 8.89522 49.1379 9.99976 49.1379H27.5993C28.1516 49.1379 28.2993 48.6979 28.2993 48.1552V25.6178C28.2993 20.0027 35.5295 17.5656 39.0361 21.9989L49.9988 35.8583V9.82759C49.9988 8.74206 50.1034 7.86207 48.9988 7.86207H9.99976Z" fill="#0C0D0D"/>
|
||||
<path d="M48.0003 0C53.523 0 58 4.39996 58 9.82759V41.5893C58 47.2045 50.7699 49.6414 47.2633 45.2082L36.3006 31.3488V48.1552C36.3006 53.04 32.2712 57 27.3008 57C27.8531 57 28.3008 56.56 28.3008 56.0172V25.6178C28.3008 20.0027 35.5309 17.5656 39.0375 21.9989L50.0002 35.8583V1.96552C50.0002 0.879992 49.1048 0 48.0003 0Z" fill="#0C0D0D"/>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 1.0 KiB |
@@ -0,0 +1,4 @@
|
||||
<svg width="58" height="57" viewBox="0 0 58 57" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<path fill-rule="evenodd" clip-rule="evenodd" d="M0 9.82759C0 4.39996 4.47705 0 9.99976 0H47.9989C53.5216 0 57.9986 4.39996 57.9986 9.82759V41.5893C57.9986 47.2045 50.7684 49.6414 47.2618 45.2082L36.2991 31.3488V48.1552C36.2991 53.04 32.2698 57 27.2993 57H9.99976C4.47705 57 0 52.6 0 47.1724V9.82759ZM9.99976 7.86207C8.89522 7.86207 7.99981 8.74206 7.99981 9.82759V47.1724C7.99981 48.2579 8.89522 49.1379 9.99976 49.1379H27.5993C28.1516 49.1379 28.2993 48.6979 28.2993 48.1552V25.6178C28.2993 20.0027 35.5295 17.5656 39.0361 21.9989L49.9988 35.8583V9.82759C49.9988 8.74206 50.1034 7.86207 48.9988 7.86207H9.99976Z" fill="white"/>
|
||||
<path d="M48.0003 0C53.523 0 58 4.39996 58 9.82759V41.5893C58 47.2045 50.7699 49.6414 47.2633 45.2082L36.3006 31.3488V48.1552C36.3006 53.04 32.2712 57 27.3008 57C27.8531 57 28.3008 56.56 28.3008 56.0172V25.6178C28.3008 20.0027 35.5309 17.5656 39.0375 21.9989L50.0002 35.8583V1.96552C50.0002 0.879992 49.1048 0 48.0003 0Z" fill="white"/>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 1.0 KiB |
Reference in new issue
Block a user