S3, Supabase, Redshift & Aurora
Four workspace connectors for the data most teams already keep on AWS or Supabase. Add them once under Connectors, press Test, and every page — and the assistant, if you allow it — can use them by name. Keys are encrypted and never reach the browser.
All four are read-only.
Amazon S3
Section titled “Amazon S3”Lists a bucket and reads CSV, JSON and text files. Bigger or binary files (PDF, images, Parquet) get a short-lived download link instead.
- In AWS, create an IAM user with
s3:ListBucketands3:GetObjecton the bucket. - Connectors → Amazon S3: bucket, region, access key ID and secret.
- Optional Folder limits the connector to one prefix (e.g.
exports/). - Optional S3-compatible endpoint for Cloudflare R2, MinIO and similar.
const sdk = await ShareOut.create();const s3 = sdk.platform.provider('s3');const { data } = await s3.execute('objects.get', { connectionId, params: { queryParams: { key: 'exports/orders.csv' } },});console.log(data.rows); // one object per CSV row, keyed by the header| Endpoint | Does |
|---|---|
objects.list |
Folders and files under prefix |
objects.get |
One file up to 10 MB: CSV → rows, JSON → data, text → text |
objects.presign |
A signed download URL, valid up to one hour |
Supabase
Section titled “Supabase”Runs SQL through Supabase’s read-only query endpoint, as the built-in
supabase_read_only_user — writes are impossible by design.
- In Supabase, Account → Access Tokens → Generate new token.
- Connectors → Supabase: paste the project URL (or ref) and the token.
Amazon Redshift
Section titled “Amazon Redshift”Uses the Redshift Data API, so private clusters work without opening them to the internet.
- Create an IAM user with
redshift-data:*and eitherredshift-serverless:GetCredentials/redshift:GetClusterCredentialsorsecretsmanager:GetSecretValuefor a stored login. - Connectors → Amazon Redshift: region, Serverless workgroup or cluster name, database, and — for a provisioned cluster — a database user or a Secrets Manager ARN.
- Give that database user read-only grants.
Amazon Aurora
Section titled “Amazon Aurora”Aurora PostgreSQL and Aurora MySQL through the RDS Data API.
- Turn on the Data API for the cluster (RDS console → Modify → Data API).
- Store a read-only database login in Secrets Manager.
- Create an IAM user with
rds-data:ExecuteStatementandsecretsmanager:GetSecretValueon that secret. - Connectors → Amazon Aurora: cluster ARN, secret ARN, database.
Plain (non-Aurora) Amazon RDS and self-hosted Postgres are not supported yet: they need a direct database socket, which ShareOut’s runtime can’t open to databases signed by a private certificate authority.
Query the SQL connectors
Section titled “Query the SQL connectors”Supabase, Redshift and Aurora share one endpoint and one result shape:
const { data } = await sdk.platform.execute('supabase', 'sql.query', { connectionId, params: { body: { sql: 'select status, count(*) as n from orders group by 1' } },});// data → { columns: ['status', 'n'], rows: [{ status: 'paid', n: 31 }, …] }Pass maxRows (up to 10 000) to cap the result. On pages with a row-level access policy,
viewers can only run queries declared in access_policy.queries, as with Snowflake.
The assistant
Section titled “The assistant”Tick AI on the connector card and the workspace assistant can query it: SQL
connectors through read-only SELECTs, S3 by browsing folders and reading files.
