Skip to content

Commit 434d32e

Browse files
committed
Revert "First pass at removing hypershift"
This reverts commit 78222ca.
1 parent 78222ca commit 434d32e

File tree

11 files changed

+64
-60
lines changed

11 files changed

+64
-60
lines changed

getting-started/next-steps.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,12 +11,17 @@ content_group: Getting started
1111

1212
To continue exploring Timescale, here are some things you might like to try:
1313

14+
* Migrate your existing data to Timescale using the
15+
[hypershift migration tool][migrate-data].
1416
* Write a program using a Timescale database backend in
1517
[your favorite programming language][connect-with-code].
18+
19+
<!--- Commenting out until these are live
1620
* Get your Timescale database integrated with a range of
1721
[third-party tools][integrations]
1822
for tasks like data ingestion, visualization, and logging.
1923
* Extend your Timescale database with [PostgreSQL extensions][extensions].
24+
-->
2025

2126
[connect-with-code]: /quick-start/:currentVersion:/
2227
[migrate-data]: /use-timescale/:currentVersion:/migration/

getting-started/time-series-data.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ layout_components: [next_prev_large]
88
content_group: Getting started
99
---
1010

11+
import HypershiftAlt from "versionContent/_partials/_hypershift-alternatively.mdx";
1112
import TimeseriesIntro from "versionContent/_partials/_timeseries-intro.mdx";
1213

1314
# Time-series data
@@ -18,6 +19,8 @@ To explore Timescale's features, you need some sample data. This tutorial
1819
provides real-time stock trade data, also known as tick data, from
1920
[Twelve Data][twelve-data].
2021

22+
<HypershiftAlt />
23+
2124
## About the dataset
2225

2326
The dataset contains second-by-second stock-trade data for the top 100
@@ -35,6 +38,8 @@ Exchange (9:30&nbsp;AM - 4:00&nbsp;PM EST).
3538
To ingest data into the tables that you created, you need to download the
3639
dataset and copy the data to your database.
3740

41+
<HypershiftAlt />
42+
3843
<Procedure>
3944

4045
### Ingesting the dataset

mst/migrate-to-cloud.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,7 @@ keywords: [data migration]
88
# Migrate your Managed Service for TimescaleDB data to Timescale
99

1010
If you prefer Timescale's features, you can migrate your data from Managed
11-
Service for TimescaleDB to Timescale using the PostgreSQL `pg_backup` and
12-
`pg_restore` tools. To learn more about migration, see the
13-
[migration section][migration].
11+
Service for TimescaleDB to Timescale using the hypershift tool. To learn about
12+
hypershift, see the [migration section][migration].
1413

1514
[migration]: /use-timescale/:currentVersion:/migration/

use-timescale/migration/pg-dump-and-restore.md renamed to self-hosted/backup-and-restore/pg-dump-and-restore.md

Lines changed: 8 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,21 @@
11
---
2-
title: Migrations using pg_dump and pg_restore
3-
excerpt: Migrate a hypertable or entire database with native PostgreSQL commands
4-
products: [cloud, self_hosted]
2+
title: Logical backups with pg_dump and pg_restore
3+
excerpt: Back up and restore a hypertable or entire database with native PostgreSQL commands
4+
products: [self_hosted]
55
keywords: [backups, restore]
66
tags: [recovery, logical backup, pg_dump, pg_restore]
77
---
88

99
import ConsiderCloud from "versionContent/_partials/_consider-cloud.mdx";
1010

11-
# Migrations using `pg_dump` and `pg_restore`
11+
# Logical backups with `pg_dump` and `pg_restore`
1212

1313
You can backup and restore an entire database or individual hypertables using
1414
the native PostgreSQL [`pg_dump`][pg_dump] and [`pg_restore`][pg_restore]
1515
commands. This works even for compressed hypertables, without having to
16-
decompress the chunks before you begin. You can also use this method to migrate
17-
data from one database to another.
16+
decompress the chunks before you begin.
1817

19-
<Highlight type="note">
20-
Timescale handles backups automatically by default. You do not need to manually
21-
back up your content. For more information about backups in Timescale, see the
22-
[backup and restore section](https://docs.timescale.com/use-timescale/latest/backup-restore-cloud/).
23-
</Highlight>
18+
<ConsiderCloud />
2419

2520
Upgrades between different versions of TimescaleDB can be done in place; you
2621
don't need to backup and restore your data. See
@@ -29,8 +24,8 @@ the [upgrading instructions][timescaledb-upgrade].
2924
<Highlight type="warning">
3025
If you are using this `pg_dump` backup method regularly, make sure you keep
3126
track of which versions of PostgreSQL and TimescaleDB you are running. For more
32-
information, see the
33-
[Troubleshooting section](https://docs.timescale.com/self-hosted/latest/self-hosted/backup-and-restore/troubleshooting/).
27+
information, see "Versions are mismatched when dumping and restoring a database"
28+
in the [Troubleshooting section](https://docs.timescale.com/self-hosted/latest/self-hosted/backup-and-restore/troubleshooting/).
3429
</Highlight>
3530

3631
## Back up your entire database

self-hosted/migration/index.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Migrate your PostgreSQL database to self-hosted TimescaleDB
33
excerpt: Migrate an existing PostgreSQL database to Timescale
44
products: [self_hosted]
5-
keywords: [data migration, self_hosted, postgresql, RDS]
5+
keywords: [data migration, self_hosted, postgresql, hypershift, RDS]
66
tags: [ingest, migrate, RDS]
77
---
88

@@ -35,6 +35,10 @@ There are several methods for migrating your data:
3535
discovery, validation, and creation. Outflux works with earlier versions of
3636
InfluxDB. It does not work with InfluxDB version 2 and later.
3737

38+
Additionally, the hypershift tool can be used to migrate most PostgreSQL
39+
databases to self-hosted TimescaleDB. For more information about hypershift, see
40+
the [hypershift documentation][hypershift].
41+
3842
## Choose a migration method
3943

4044
Which method you choose depends on your database size, network upload and
@@ -48,7 +52,10 @@ data egressed, even if the migration fails.
4852
</Highlight>
4953

5054
If your database is smaller than 100&nbsp;GB, choose to migrate your entire
51-
database at once. You can also migrate larger databases using this method, but
55+
database at once. If your source database is PostgreSQL, use the hypershift
56+
tool to avoid having to dump your data to a directory before restoring it.
57+
58+
You can also migrate larger databases using this method, but
5259
the copying process must keep running, potentially over days or weeks. If the
5360
copy is interrupted, the process needs to be restarted. If you think an
5461
interruption in the copy is possible, choose to migrate your schema and data
@@ -79,3 +86,4 @@ backfill your data with one of the two migration methods.
7986
[migrate-separately]: /self-hosted/:currentVersion:/migration/schema-then-data/
8087
[migrate-same-db]: /self-hosted/:currentVersion:/migration/same-db/
8188
[outflux]: /self-hosted/:currentVersion:/migration/migrate-influxdb/
89+
[hypershift]: /use-timescale/:currentVersion:/migration/

use-timescale/migration/OLD_hypershift-content/OLD_index.md

Lines changed: 0 additions & 34 deletions
This file was deleted.
File renamed without changes.
File renamed without changes.

use-timescale/migration/index.md

Lines changed: 20 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,33 @@
22
title: Migrate your data to Timescale
33
excerpt: Migrate existing database to Timescale
44
products: [cloud]
5-
keywords: [data migration, postgresql, RDS]
5+
keywords: [data migration, postgresql, hypershift, RDS]
66
tags: [ingest, migrate, RDS]
77
---
88

99
# Migrate your data to Timescale
1010

11-
You can migrate data from another database into Timescale using the PostgreSQL
12-
`pg_dump` and `pg_restore` commands. You can also use these tools to migrate
13-
your data from Managed Service for TimescaleDB, from a self-hosted Timescale
14-
instance, or from another PostgreSQL database, including Amazon RDS.
11+
You can migrate data from another database into Timescale
12+
using Timescale Hypershift. You can also use hypershift to migrate your data
13+
from Managed Service for TimescaleDB, from a self-hosted Timescale instance, or
14+
from another PostgreSQL database, including Amazon RDS.
15+
16+
* [Understand how hypershift works][about-hypershift] before you begin using it.
17+
* [Migrate your data with hypershift][migrate-hypershift].
18+
* [Configure hypershift][configure-hypershift].
1519

1620
If you want to import data from another format, such as a `.csv` file, into a
1721
new Timescale service, see the [data ingest section][data-ingest].
1822

23+
If you want to migrate existing data into a self-hosted Timescale installation,
24+
see the [self-hosted data migration section][self-hosted-migration].
25+
26+
If you want to migrate existing data into Managed Service for TimescaleDB, see
27+
the [Managed Service for TimescaleDB migration section][mst-migration].
28+
1929
[data-ingest]: /use-timescale/:currentVersion:/ingest-data/
30+
[self-hosted-migration]: /self-hosted/:currentVersion:/migration/
31+
[mst-migration]: /mst/:currentVersion:/migrate-to-mst/
32+
[about-hypershift]: /use-timescale/:currentVersion:/migration/about-hypershift/
33+
[migrate-hypershift]: /use-timescale/:currentVersion:/migration/migrate-hypershift/
34+
[configure-hypershift]: /use-timescale/:currentVersion:/migration/hypershift-config/
File renamed without changes.

0 commit comments

Comments
 (0)