{"id":27933451,"url":"https://github.com/timescale/migration-eval","last_synced_at":"2025-05-07T04:58:49.707Z","repository":{"id":230193692,"uuid":"684300836","full_name":"timescale/migration-eval","owner":"timescale","description":"Tools to determine a migration strategy based on your database","archived":false,"fork":false,"pushed_at":"2024-06-19T12:33:58.000Z","size":27,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-05-07T04:58:44.793Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timescale.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-28T21:27:38.000Z","updated_at":"2024-12-03T08:25:36.000Z","dependencies_parsed_at":"2024-04-09T09:51:26.293Z","dependency_job_id":"4ef5c37a-bd76-4573-8e6b-c6a673d21aa5","html_url":"https://github.com/timescale/migration-eval","commit_stats":null,"previous_names":["timescale/migration-eval"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timescale%2Fmigration-eval","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timescale%2Fmigration-eval/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timescale%2Fmigration-eval/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timescale%2Fmigration-eval/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timescale","download_url":"https://codeload.github.com/timescale/migration-eval/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252816948,"owners_count":21808704,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-07T04:58:49.189Z","updated_at":"2025-05-07T04:58:49.700Z","avatar_url":"https://github.com/timescale.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# migration-eval\n\nThis repository provides scripts that assist the Timescale migration team\nin selecting the optimal migration strategy to Timescale Cloud for your\nspecific database.\n\nTo run the script, you will need `psql`. Make sure you can connect to your\ndatabase with `psql` before you proceed.\n\nTo recommend an appropriate migration strategy for your database, we need\ninformation about its current state. You can gather this information by\nrunning the following command during **periods of peak write activity** in\nyour database:\n\n```sh\ncurl -sL https://assets.timescale.com/releases/migration/evaluate.sql | psql -t -q -v sampling_interval=60 -d \"POSTGRES_URI\" -f - \u003e report.txt\n```\n\nwhere\n- `POSTGRES_URI` is the URI of your source database.\n- `sampling_interval` is the amount of time in _seconds_ to consider while computing rate based metrics, eg, rate of transactions per second. This argument is optional and defaults to 60 seconds.\n\nThe above command will:\n- Download the latest evaluation script\n- Run queries against your Postgres database\n- Save the results necessary for evaluating the suitable migration strategy to a file named \"report.txt\"\n\nPlease share the generated \"report.txt\" file with us for further analysis.\n\nWhen executed on a database with TimescaleDB installed, the script generates the following report:\n\n```text\nPostgreSQL version: PostgreSQL 15.6 on x86_64-pc-linux-gnu, compiled by gcc (GCC) 13.2.1 20231011 (Red Hat 13.2.1-4), 64-bit\nDatabase size: 751 MB\nNum tables: 74\nNum regular PostgreSQL tables excl. Hypertables: 8\nNum declarative partitions: 2\nNon-standard tablespaces: -\nCurrent database: tsbs\nOther databases: {_timescaledb,defaultdb}\nSchemas: {public,iot}\nTimescaleDB version: 2.13.1\nNum TimescaleDB Hypertables: 2\nNum TimescaleDB Continuous Aggregates: 1\nNum TimescaleDB space dimensions: 2\nTimescaleDB extension schema: public\nTimescaleDB features: {hypertables,continuous_aggregates,retention,compression,background_jobs}\nUnsupported extensions in Timescale Cloud: [{\"aiven_extras\" : \"1.1.12\"}]\nRate of inserts, updates, deletes and transactions (per sec): 10791.750, 0.000, 0.000, 43.667\nDo tables have generated columns: f\nDo tables attributes have NaN, Infinity or -Infinity*: f\nWAL activity: 19786.500 wal_records_per_sec, 2.172 wal_megabytes_per_sec\n```\n\nNote: Metrics with an asterisk (*) will require further confirmation from the user.\nThis is because they represent the temporary state of the database, and the actual answer\nmay vary depending on the applications.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimescale%2Fmigration-eval","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimescale%2Fmigration-eval","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimescale%2Fmigration-eval/lists"}