Skip to content

OpenPanel is an open-source web and product analytics platform, an open-source alternative to Mixpanel with optional self-hosting.

8.7 KB
Raw Blame
import {
  chMigrationClient,
  createTable,
  moveDataBetweenTables,
  renameTable,
  runClickhouseMigrationCommands,
} from '../clickhouse/migration';
import { type CodeMigrationEnv, getIsCluster, writeSqlDump } from './helpers';

export async function up(env: CodeMigrationEnv) {
  const isClustered = getIsCluster(env);

  const sqls: string[] = [];

  const eventTables = createTable({
    name: 'events_new_20251123',
    columns: [
      '`id` UUID DEFAULT generateUUIDv4()',
      '`name` LowCardinality(String)',
      '`sdk_name` LowCardinality(String)',
      '`sdk_version` LowCardinality(String)',
      '`device_id` String CODEC(ZSTD(3))',
      '`profile_id` String CODEC(ZSTD(3))',
      '`project_id` String CODEC(ZSTD(3))',
      '`session_id` String CODEC(LZ4)',
      '`path` String CODEC(ZSTD(3))',
      '`origin` String CODEC(ZSTD(3))',
      '`referrer` String CODEC(ZSTD(3))',
      '`referrer_name` String CODEC(ZSTD(3))',
      '`referrer_type` LowCardinality(String)',
      '`revenue` UInt64',
      '`duration` UInt64 CODEC(Delta(4), LZ4)',
      '`properties` Map(String, String) CODEC(ZSTD(3))',
      '`created_at` DateTime64(3) CODEC(DoubleDelta, ZSTD(3))',
      '`country` LowCardinality(FixedString(2))',
      '`city` String',
      '`region` LowCardinality(String)',
      '`longitude` Nullable(Float32) CODEC(Gorilla, LZ4)',
      '`latitude` Nullable(Float32) CODEC(Gorilla, LZ4)',
      '`os` LowCardinality(String)',
      '`os_version` LowCardinality(String)',
      '`browser` LowCardinality(String)',
      '`browser_version` LowCardinality(String)',
      '`device` LowCardinality(String)',
      '`brand` LowCardinality(String)',
      '`model` LowCardinality(String)',
      '`imported_at` Nullable(DateTime) CODEC(Delta(4), LZ4)',
    ],
    indices: [
      'INDEX idx_name name TYPE bloom_filter GRANULARITY 1',
      "INDEX idx_properties_bounce properties['__bounce'] TYPE set(3) GRANULARITY 1",
      'INDEX idx_origin origin TYPE bloom_filter(0.05) GRANULARITY 1',
      'INDEX idx_path path TYPE bloom_filter(0.01) GRANULARITY 1',
    ],
    orderBy: ['project_id', 'toDate(created_at)', 'created_at', 'name'],
    partitionBy: 'toYYYYMM(created_at)',
    settings: {
      index_granularity: 8192,
      // For lightweight updates
      enable_block_offset_column: 1,
      enable_block_number_column: 1,
    },
    distributionHash:
      'cityHash64(project_id, toString(toStartOfHour(created_at)))',
    replicatedVersion: '1',
    isClustered,
  });

  sqls.push(...eventTables);

  const sessionTables = createTable({
    name: 'sessions_new_20251123',
    engine: 'VersionedCollapsingMergeTree(sign, version)',
    columns: [
      '`id` String',
      '`project_id` String CODEC(ZSTD(3))',
      '`profile_id` String CODEC(ZSTD(3))',
      '`device_id` String CODEC(ZSTD(3))',
      '`created_at` DateTime64(3) CODEC(DoubleDelta, ZSTD(3))',
      '`ended_at` DateTime64(3) CODEC(DoubleDelta, ZSTD(3))',
      '`is_bounce` Bool',
      '`entry_origin` LowCardinality(String)',
      '`entry_path` String CODEC(ZSTD(3))',
      '`exit_origin` LowCardinality(String)',
      '`exit_path` String CODEC(ZSTD(3))',
      '`screen_view_count` Int32',
      '`revenue` Float64',
      '`event_count` Int32',
      '`duration` UInt32',
      '`country` LowCardinality(FixedString(2))',
      '`region` LowCardinality(String)',
      '`city` String',
      '`longitude` Nullable(Float32) CODEC(Gorilla, LZ4)',
      '`latitude` Nullable(Float32) CODEC(Gorilla, LZ4)',
      '`device` LowCardinality(String)',
      '`brand` LowCardinality(String)',
      '`model` LowCardinality(String)',
      '`browser` LowCardinality(String)',
      '`browser_version` LowCardinality(String)',
      '`os` LowCardinality(String)',
      '`os_version` LowCardinality(String)',
      '`utm_medium` String CODEC(ZSTD(3))',
      '`utm_source` String CODEC(ZSTD(3))',
      '`utm_campaign` String CODEC(ZSTD(3))',
      '`utm_content` String CODEC(ZSTD(3))',
      '`utm_term` String CODEC(ZSTD(3))',
      '`referrer` String CODEC(ZSTD(3))',
      '`referrer_name` String CODEC(ZSTD(3))',
      '`referrer_type` LowCardinality(String)',
      '`sign` Int8',
      '`version` UInt64',
    ],
    orderBy: ['project_id', 'toDate(created_at)', 'created_at'],
    partitionBy: 'toYYYYMM(created_at)',
    settings: {
      index_granularity: 8192,
    },
    distributionHash:
      'cityHash64(project_id, toString(toStartOfHour(created_at)))',
    replicatedVersion: '1',
    isClustered,
  });

  sqls.push(...sessionTables);

  const firstEventDateResponse = await chMigrationClient.query({
    query: 'SELECT min(created_at) as created_at FROM events',
    format: 'JSONEachRow',
  });
  const firstEventDateJson = await firstEventDateResponse.json<{
    created_at: string;
  }>();
  if (
    firstEventDateJson[0]?.created_at &&
    !firstEventDateJson[0]?.created_at.startsWith('1970')
  ) {
    const firstEventDate = new Date(firstEventDateJson[0]?.created_at);
    // First of next month, so the current month is fully captured.
    const endDate = new Date();
    endDate.setMonth(endDate.getMonth() + 1);
    endDate.setDate(1);

    sqls.push(
      ...moveDataBetweenTables({
        from: 'events',
        to: 'events_new_20251123',
        batch: {
          startDate: firstEventDate,
          endDate,
          column: 'toDate(created_at)',
          interval: 'month',
          transform: (date: Date) => {
            const year = date.getFullYear();
            const month = String(date.getMonth() + 1).padStart(2, '0');
            return `${year}-${month}-01`;
          },
        },
      })
    );
  }

  const firstSessionDateResponse = await chMigrationClient.query({
    query: 'SELECT min(created_at) as created_at FROM sessions',
    format: 'JSONEachRow',
  });
  const firstSessionDateJson = await firstSessionDateResponse.json<{
    created_at: string;
  }>();

  if (
    firstSessionDateJson[0]?.created_at &&
    !firstSessionDateJson[0]?.created_at.startsWith('1970')
  ) {
    const firstSessionDate = new Date(
      firstSessionDateJson[0]?.created_at ?? ''
    );
    // First of next month, so the current month is fully captured.
    const endDate = new Date();
    endDate.setMonth(endDate.getMonth() + 1);
    endDate.setDate(1);

    sqls.push(
      ...moveDataBetweenTables({
        from: 'sessions',
        to: 'sessions_new_20251123',
        columns: [
          'id',
          'project_id',
          'profile_id',
          'device_id',
          'created_at',
          'ended_at',
          'is_bounce',
          'entry_origin',
          'entry_path',
          'exit_origin',
          'exit_path',
          'screen_view_count',
          'revenue',
          'event_count',
          'duration',
          'country',
          'region',
          'city',
          'longitude',
          'latitude',
          'device',
          'brand',
          'model',
          'browser',
          'browser_version',
          'os',
          'os_version',
          'utm_medium',
          'utm_source',
          'utm_campaign',
          'utm_content',
          'utm_term',
          'referrer',
          'referrer_name',
          'referrer_type',
          'sign',
          'version',
        ],
        batch: {
          startDate: firstSessionDate,
          endDate,
          column: 'toDate(created_at)',
          interval: 'month',
          transform: (date: Date) => {
            const year = date.getFullYear();
            const month = String(date.getMonth() + 1).padStart(2, '0');
            return `${year}-${month}-01`;
          },
        },
      })
    );
  }

  sqls.push(
    ...renameTable({ from: 'events', to: 'events_20251123', isClustered })
  );
  sqls.push(
    ...renameTable({ from: 'sessions', to: 'sessions_20251123', isClustered })
  );

  if (isClustered && sessionTables[1] && eventTables[1]) {
    sqls.push(
      `DROP TABLE IF EXISTS events_new_20251123 ON CLUSTER '{cluster}'`,
      `DROP TABLE IF EXISTS sessions_new_20251123 ON CLUSTER '{cluster}'`,
      `RENAME TABLE events_new_20251123_replicated TO events_replicated ON CLUSTER '{cluster}'`,
      `RENAME TABLE sessions_new_20251123_replicated TO sessions_replicated ON CLUSTER '{cluster}'`,
      eventTables[1].replaceAll('events_new_20251123', 'events'),
      sessionTables[1].replaceAll('sessions_new_20251123', 'sessions')
    );
  } else {
    sqls.push(
      ...renameTable({
        from: 'events_new_20251123',
        to: 'events',
        isClustered,
      })
    );
    sqls.push(
      ...renameTable({
        from: 'sessions_new_20251123',
        to: 'sessions',
        isClustered,
      })
    );
  }

  writeSqlDump(import.meta.url, sqls);

  if (!process.argv.includes('--dry')) {
    await runClickhouseMigrationCommands(sqls);
  }
}