mirror of
https://github.com/supabase/supabase.git
synced 2026-09-07 10:29:14 +08:00
## Summary Adds initial-copy scoping to Pipelines in Studio. Users can copy all existing rows, skip all initial copies, copy only selected publication tables, or skip selected table copies. All publication tables continue streaming new changes regardless of the initial-copy policy. The policy now round-trips through create, edit, validation, and the generated Management API contract. Initial-copy estimates and table-restart confirmations use the same scope. Edit requests also preserve redacted credentials and pipeline settings that Studio does not own. This completes the Studio layer of the [ETL API change](https://github.com/supabase/etl/pull/897) and [Management API change](https://github.com/supabase/platform/pull/35479). ## Screenshots ### Selector <img width="1153" height="465" alt="image" src="https://github.com/user-attachments/assets/bf615e82-ee61-4222-979d-a8695a957e82" /> ### Select certain tables only <img width="1153" height="465" alt="image" src="https://github.com/user-attachments/assets/28adaa24-f239-4d1d-8fb8-fdb1988320cd" /> ### Confirm copy costs As the final step before the pipeline is created: <img width="597" height="619" alt="image" src="https://github.com/user-attachments/assets/a660bd87-bfb8-41c5-8099-4cdbdef943bf" /> ### Policy-aware initial-copy estimate #### Copy no table is selected <img width="407" height="464" alt="image" src="https://github.com/user-attachments/assets/99d859ec-2ec3-452a-ab69-11924a8db260" /> #### Some tables are selected <img width="407" height="464" alt="image" src="https://github.com/user-attachments/assets/e68aedf4-66bc-4372-98ef-0dd7fecef324" /> <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit - **New Features** - Added configurable “initial table copy” policies (copy/skip all and copy/skip selected) during replication setup, including table-picker behavior, pruning of stale selections, and updated restart/cost estimates. - **Bug Fixes** - Improved restart flows to consistently use `schema.table` identity and simplified “errored tables” targeting to match error-state tables. - Reduced unnecessary loading by gating publication/table fetches to when panels are visible; improved validation/toast handling when publication tables are unavailable. - **Tests** - Added/expanded coverage for destination form submission, table-copy selection, restart/cost dialogs, and copy-estimate summarization. - **Style** - Refreshed warning/label text for clearer configuration and confirmation messaging. <!-- end of auto-generated comment: release notes by coderabbit.ai --> --------- Co-authored-by: Victor Farazdagi <simple.square@gmail.com> Co-authored-by: Joshen Lim <joshenlimek@gmail.com>
160 lines
4.8 KiB
TypeScript
160 lines
4.8 KiB
TypeScript
import { useMutation } from '@tanstack/react-query'
|
|
import type { components } from 'api-types'
|
|
|
|
import {
|
|
buildDucklakeApiConfig,
|
|
DestinationConfig,
|
|
TableSyncCopyConfig,
|
|
} from './create-destination-pipeline-mutation'
|
|
import { handleError, post } from '@/data/fetchers'
|
|
import type { ResponseError, UseCustomMutationOptions } from '@/types'
|
|
|
|
type ValidateDestinationParams = {
|
|
projectRef: string
|
|
destinationConfig: DestinationConfig
|
|
sourceId?: number
|
|
publicationName?: string
|
|
maxFillMs?: number
|
|
maxTableSyncWorkers?: number
|
|
maxCopyConnectionsPerTable?: number
|
|
invalidatedSlotBehavior?: 'error' | 'recreate'
|
|
tableSyncCopy?: TableSyncCopyConfig
|
|
}
|
|
|
|
type ValidateDestinationResponse = components['schemas']['ValidateDestinationResponse']
|
|
export type ValidationFailure = ValidateDestinationResponse['validation_failures'][number]
|
|
|
|
async function validateDestination(
|
|
{
|
|
projectRef,
|
|
destinationConfig,
|
|
sourceId,
|
|
publicationName,
|
|
maxFillMs,
|
|
maxTableSyncWorkers,
|
|
maxCopyConnectionsPerTable,
|
|
invalidatedSlotBehavior,
|
|
tableSyncCopy,
|
|
}: ValidateDestinationParams,
|
|
signal?: AbortSignal
|
|
): Promise<ValidateDestinationResponse> {
|
|
if (!projectRef) throw new Error('projectRef is required')
|
|
|
|
// Build destination_config based on the type
|
|
let config: components['schemas']['ValidateReplicationDestinationBody']['config']
|
|
|
|
if ('bigQuery' in destinationConfig) {
|
|
const { projectId, datasetId, serviceAccountKey, connectionPoolSize, maxStalenessMins } =
|
|
destinationConfig.bigQuery
|
|
|
|
config = {
|
|
big_query: {
|
|
project_id: projectId,
|
|
dataset_id: datasetId,
|
|
service_account_key: serviceAccountKey,
|
|
connection_pool_size: connectionPoolSize,
|
|
max_staleness_mins: maxStalenessMins,
|
|
},
|
|
} as components['schemas']['ValidateReplicationDestinationBody']['config']
|
|
} else if ('iceberg' in destinationConfig) {
|
|
const {
|
|
projectRef: icebergProjectRef,
|
|
namespace,
|
|
warehouseName,
|
|
catalogToken,
|
|
s3AccessKeyId,
|
|
s3SecretAccessKey,
|
|
s3Region,
|
|
} = destinationConfig.iceberg
|
|
|
|
config = {
|
|
iceberg: {
|
|
supabase: {
|
|
namespace,
|
|
project_ref: icebergProjectRef,
|
|
warehouse_name: warehouseName,
|
|
catalog_token: catalogToken,
|
|
s3_access_key_id: s3AccessKeyId,
|
|
s3_secret_access_key: s3SecretAccessKey,
|
|
s3_region: s3Region,
|
|
},
|
|
},
|
|
}
|
|
} else if ('ducklake' in destinationConfig) {
|
|
config = buildDucklakeApiConfig(
|
|
destinationConfig.ducklake
|
|
) as components['schemas']['ValidateReplicationDestinationBody']['config']
|
|
} else if ('snowflake' in destinationConfig) {
|
|
const { accountId, user, privateKey, privateKeyPassphrase, database, schema, role } =
|
|
destinationConfig.snowflake
|
|
|
|
config = {
|
|
snowflake: {
|
|
account_id: accountId,
|
|
user,
|
|
private_key: privateKey,
|
|
private_key_passphrase: privateKeyPassphrase,
|
|
database,
|
|
schema,
|
|
role,
|
|
},
|
|
} as components['schemas']['ValidateReplicationDestinationBody']['config']
|
|
} else if ('clickHouse' in destinationConfig) {
|
|
const { url, user, password, database, engine } = destinationConfig.clickHouse
|
|
|
|
config = {
|
|
clickhouse: {
|
|
url,
|
|
user,
|
|
password,
|
|
database,
|
|
engine,
|
|
},
|
|
} as components['schemas']['ValidateReplicationDestinationBody']['config']
|
|
} else {
|
|
throw new Error(
|
|
'Invalid destination config: must specify bigQuery, iceberg, ducklake, snowflake, or clickHouse'
|
|
)
|
|
}
|
|
|
|
const batchConfig = maxFillMs !== undefined ? { max_fill_ms: maxFillMs } : undefined
|
|
const pipelineConfig =
|
|
publicationName === undefined
|
|
? undefined
|
|
: {
|
|
publication_name: publicationName,
|
|
max_table_sync_workers: maxTableSyncWorkers,
|
|
max_copy_connections_per_table: maxCopyConnectionsPerTable,
|
|
invalidated_slot_behavior: invalidatedSlotBehavior,
|
|
table_sync_copy: tableSyncCopy,
|
|
batch: batchConfig,
|
|
}
|
|
|
|
const { data, error } = await post('/platform/replication/{ref}/destinations/validate', {
|
|
params: { path: { ref: projectRef } },
|
|
body: {
|
|
config,
|
|
source_id: sourceId,
|
|
pipeline_config: pipelineConfig,
|
|
},
|
|
signal,
|
|
})
|
|
|
|
if (error) handleError(error)
|
|
return data as ValidateDestinationResponse
|
|
}
|
|
|
|
type ValidateDestinationData = Awaited<ReturnType<typeof validateDestination>>
|
|
|
|
export const useValidateDestinationMutation = (
|
|
options?: Omit<
|
|
UseCustomMutationOptions<ValidateDestinationData, ResponseError, ValidateDestinationParams>,
|
|
'mutationFn'
|
|
>
|
|
) => {
|
|
return useMutation<ValidateDestinationData, ResponseError, ValidateDestinationParams>({
|
|
mutationFn: (vars) => validateDestination(vars),
|
|
...options,
|
|
})
|
|
}
|