Skip to content

Redshift (Destination)

Loads data into Amazon Redshift using a staging location in S3 (COPY workflow).

Configuration

yaml
warehouse:
  kind: redshift
  database: analytics
  cluster_identifier: my-cluster
  schema: public
  region: us-east-1
  staging_s3_bucket: my-load-bucket
  staging_s3_prefix: "skippr/staging/"
  iam_role_arn: "arn:aws:iam::123456789012:role/RedshiftS3Role"
FieldDefaultDescription
database(required)Redshift database name
schemapublicTarget schema
cluster_identifierProvisioned cluster identifier
workgroup_nameServerless workgroup (alternative to cluster)
db_userDatabase user for COPY
regionAWS region
staging_s3_bucketS3 bucket for staging files before COPY
staging_s3_prefixPrefix inside the staging bucket
iam_role_arnIAM role Redshift uses to read from S3

CLI

bash
skippr connect warehouse redshift \
  --database analytics \
  --cluster-identifier my-cluster \
  --db-user admin \
  --schema public \
  --region us-east-1
FlagDescription
--databaseRedshift database name
--cluster-identifierProvisioned cluster ID (use this or --workgroup-name)
--workgroup-nameServerless workgroup name (use this or --cluster-identifier)
--db-userDatabase user (provisioned clusters)
--schemaTarget schema (default: public)
--regionAWS region

Authentication uses the AWS default credential chain (env vars, instance profile, SSO).

CDC

Redshift supports CDC with staging-table MERGE semantics. Skippr automatically creates _skippr_order_token columns and tombstone tables.

See CDC Destinations -- Redshift for details.