gotosocial/internal/db/bundb/migrations
2024-03-10 13:27:31 +01:00
..
20211113114307_init [bugfix] Allow lowercase emoji shortcode in frontend (#1851) 2023-06-02 17:42:14 +02:00
20220214175650_media_cleanup [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220315160814_admin_account_actions [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220905150505_custom_emoji_updates [bugfix] Allow lowercase emoji shortcode in frontend (#1851) 2023-06-02 17:42:14 +02:00
20230328203024_migration_fix [feature] Account alias / move API + db models (#2518) 2024-01-16 16:22:44 +00:00
20211113114307_init.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220214175650_media_cleanup.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220305130328_database_optimizations.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220315160814_admin_account_actions.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220502113806_add_missing_indexes.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220506110822_add_account_raw_note.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220511165212_add_account_raw_note_fix.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220518123621_additional_indexing.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220612091800_duplicated_media_cleanup.go [feature] add per-uri dereferencer locks (#2291) 2023-10-31 11:12:22 +00:00
20220710153020_fix_slow_web_profile_queries.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220804120132_account_default_post_format.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220823140228_user_custom_css.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220827085121_assign_missing_in_reply_to_uris.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220830014732_regenerate_indexes_for_follows.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220903141016_store_gifs_as_image.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220905150505_custom_emoji_updates.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220916122701_emojis_in_accounts.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220922142408_shared_inbox_delivery.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20220926115233_indexes.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20221006114842_add_rss_functionality.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20221011125732_refetch_updated_emojis.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20221031145649_emoji_categories.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20221103203553_add_external_id.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20221108142419_create_account_tombstones.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20221220134514_mp4_jiggery_pokery.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20230105171144_report_model.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20230126170719_format_to_content_type.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20230202212700_rename_account_webfingered_to_fetched.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20230221150957_status_pin_client_api.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
20230328203024_migration_fix.go [feature] Account alias / move API + db models (#2518) 2024-01-16 16:22:44 +00:00
20230405130021_status_fave_unique_constraints.go [bugfix] Add proper constraints on status faves, dedupe (#1674) 2023-04-05 20:10:05 +02:00
20230430105735_fieldwork.go [feature] Enable federation in/out of profile PropertyValue fields (#1722) 2023-05-09 11:16:10 +01:00
20230511181430_add_status_fetched_at.go [feature] status refetch support (#1690) 2023-05-12 11:15:54 +02:00
20230515173919_lists.go [feature] Add List functionality (#1802) 2023-05-25 10:37:38 +02:00
20230521105850_emoji_empty_domain_fix.go [bugfix] Fix incorrect default for empty emoji domain (#1803) 2023-05-21 13:45:24 +02:00
20230620103932_search_updates.go [feature] Add partial text search for accounts + statuses (#1836) 2023-06-21 17:26:40 +01:00
20230711214815_account_notes.go [feature] Support setting private notes on accounts (#1982) 2023-07-27 10:30:39 +02:00
20230713025939_markers_api.go [feature] Implement markers API (#1989) 2023-07-29 12:49:14 +02:00
20230718161520_hashtaggery.go [feature] Hashtag federation (in/out), hashtag client API endpoints (#2032) 2023-07-31 15:47:35 +02:00
20230724100000_emoji_cleanup.go [feature/performance] support uncaching remote emoji + scheduled cleanup functions (#1987) 2023-07-24 13:14:13 +01:00
20230815164500_rules_model.go [feature] Instance rules (#2125) 2023-08-19 14:33:15 +02:00
20230817174700_add_report_rule_ids.go [feature] Instance rules (#2125) 2023-08-19 14:33:15 +02:00
20230821075342_attachment_cleanup_updates.go [performance] Tweak media attachment cleanup; replace stale index (#2143) 2023-08-21 14:03:04 +01:00
20230828101322_admin_action_locking.go [feature] Store admin actions in the db, prevent conflicting actions (#2167) 2023-09-04 14:55:17 +01:00
20230905133904_remote_pubkey_expiry.go [feature] Allow admins to expire remote public keys; refetch expired keys on demand (#2183) 2023-09-12 10:43:12 +01:00
20230908083121_allowlist.go.go [feature] Implement explicit domain allows + allowlist federation mode (#2200) 2023-09-21 12:12:04 +02:00
20231002153327_add_status_polls.go [feature] add support for polls + receiving federated status edits (#2330) 2023-11-08 14:32:17 +00:00
20231016113235_mute_status_thread.go [feature] Status thread mute/unmute functionality (#2278) 2023-10-25 15:04:53 +01:00
20231029143819_remove_suspended_at_index.go Remove account_suspended_at_idx to resolve slow query issues (#2310) 2023-10-31 13:43:33 +00:00
20231110142330_small_poll_table_tweaks.go [bugfix] Update poll delete/update db queries (#2361) 2023-11-14 12:43:27 +00:00
20231128140847_remove_duplicate_indices.go [chore] Re-add indexes, rename account actions indexes (#2401) 2023-11-30 11:22:35 +00:00
20231130103643_fix_index_whoopsie.go [chore] Re-add indexes, rename account actions indexes (#2401) 2023-11-30 11:22:35 +00:00
20231208152242_sqlite_analyze.go [chore] Run ANALYZE for SQLite after latest migrations (#2427) 2023-12-08 16:59:20 +01:00
20231212144715_add_header_filters.go [feature] request blocking by http headers (#2409) 2023-12-18 14:18:25 +00:00
20231215115920_add_status_poll_index.go [bugfix] use a much shorter refresh limit for statuses with polls (#2453) 2023-12-15 15:24:39 +01:00
20231227110845_instance_description_updates.go [feature] Parse instance descriptors as markdown, show T&C on /about (#2481) 2024-01-05 13:39:31 +01:00
20240103170945_moved_to_also_known_as.go [feature] Account alias / move API + db models (#2518) 2024-01-16 16:22:44 +00:00
20240114112637_postgres_header_filter_fix.go [bugfix] Replace named unique constraint on header filter header with generic unique directive (#2525) 2024-01-15 15:39:10 +00:00
20240126064004_add_filters.go [feature] Filters v1 (#2594) 2024-03-06 11:15:58 +01:00
20240129170725_moved_to_also_known_as.go [feature/chore] Add Move database functions + cache (#2647) 2024-03-06 11:18:57 +01:00
20240220204526_add_statuses_mentions_is_null_or_empty_idx.go [chore] re-add statuses_account_id_id_idx if removed (#2699) 2024-02-28 12:53:46 +01:00
20240228113608_readd_statuses_account_id_id_idx.go [chore] re-add statuses_account_id_id_idx if removed (#2699) 2024-02-28 12:53:46 +01:00
20240310120046_fix_empty_move_id.go [bugfix] Fix whitespace move_id issue (#2742) 2024-03-10 13:27:31 +01:00
main.go [chore] Improve copyright header handling (#1608) 2023-03-12 16:00:57 +01:00
README.md [chore/docs] Replace specific year range of copyright notice (#2520) 2024-01-13 16:33:53 +01:00

Migrations

How do I write a migration file?

See here

As a template, take one of the existing migration files and modify it, or use the below code snippet:

// GoToSocial
// Copyright (C) GoToSocial Authors admin@gotosocial.org
// SPDX-License-Identifier: AGPL-3.0-or-later
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

package migrations

import (
    "context"

    "github.com/uptrace/bun"
)

func init() {
    up := func(ctx context.Context, db *bun.DB) error {
        return db.RunInTx(ctx, nil, func(ctx context.Context, tx bun.Tx) error {
            // your logic here
            return nil
        })
    }

    down := func(ctx context.Context, db *bun.DB) error {
        return db.RunInTx(ctx, nil, func(ctx context.Context, tx bun.Tx) error {
            // your logic here
            return nil
        })
    }

    if err := Migrations.Register(up, down); err != nil {
        panic(err)
    }
}

File format

Bun requires a very specific format: 14 digits, then letters or underscores.

You can use the following bash command on your branch to generate a suitable migration filename.

echo "$(date --utc +%Y%m%d%H%M%S | head -c 14)_$(git rev-parse --abbrev-ref HEAD).go"

Rules of thumb

  1. DON'T DROP TABLES!!!!!!!!
  2. Don't make something NOT NULL if it's likely to already contain null fields.