Gemeenschappelijke queryvelden
query(required bij SQL connectors).maxRowsoptioneel.parameters(typed keyvalue).includeRequestParams/allowedRequestParams/requestParamMap.
Datasource reference
Connector field reference (per type)
Volledige connectorvelden zoals ze in de admin editor beschikbaar zijn. Gebruik deze pagina als technische referentie naast Datasources hub.
1. BigQuery
| Field | Control | Required | Beschrijving |
|---|---|---|---|
description | text | No | Human-friendly omschrijving. |
serviceAccountKey | textarea(JSON) | No | Service account key override. |
projectId | text | No | Project override voor querycontext. |
billingProject | text | No | Billing project voor kostenallocatie. |
query | textarea | Yes | SQL query. |
defaultDataset | text | No | Dataset voor onvolledig gekwalificeerde tabellen. |
location | text | No | BigQuery locatie. |
maximumBytesBilled | number | No | Kostenlimiet per job. |
priority | select | No | INTERACTIVE of BATCH. |
useLegacySql | toggle | No | Legacy SQL mode. |
dryRun | toggle | No | Alleen valideren, niet uitvoeren. |
labels | keyvalue | No | Job labels. |
2. Firestore
| Field | Control | Required | Beschrijving |
|---|---|---|---|
description | text | No | Omschrijving. |
projectId | text | No | Project override. |
databaseId | text | No | Firestore database id. |
serviceAccountKey | textarea(JSON) | No | Service account key override. |
documentPath | text | No | Single document target. |
collectionPath | text | No | Collection list target. |
includeDocumentId | toggle | No | Doc ID opnemen in output. |
select | list | No | Te selecteren velden. |
filters | textarea(JSON) | No | Statische filterarray. |
requestFilters | textarea(JSON) | No | Mapping van request params naar Firestore filters. |
orderBy | textarea(JSON) | No | Sortering definitie. |
limit | number | No | Max aantal records. |
offset | number | No | Offset. |
3. MongoDB
| Field | Control | Required | Beschrijving |
|---|---|---|---|
description | text | No | Omschrijving. |
uri | text | Yes | Connection URI. |
database | text | Yes | Database naam. |
collection | text | Yes | Collection naam. |
clientOptions | textarea(JSON) | No | Extra Mongo client opties. |
query | textarea(JSON) | No | find() filter. |
projection | textarea(JSON) | No | Kolomprojectie. |
sort | textarea(JSON) | No | Sortering. |
skip, limit | number | No | Paginering. |
maxTimeMs | number | No | Query timeout. |
requestFilters | textarea(JSON) | No | Dynamische filters op request params. |
pipeline | textarea(JSON) | No | Aggregatie pipeline. |
requestStages | textarea(JSON) | No | Aanvullende stages op basis van request. |
4. SQL connectorfamilie
MySQL, Postgres, SQL Server, Firebird en Snowflake volgen hetzelfde patroon: connection + query + parameters + optionele session settings.
Session/advanced velden
- MySQL:
maxExecutionTimeMs. - Postgres:
role,searchPath,statementTimeoutMs,sessionSettings. - Snowflake:
sessionParametersen connectie-specifieke auth velden. - SQL Server:
timeoutSeconds,queryTimeoutSeconds,tdsVersion,useMars.
| Connector | Belangrijkste connection fields | Specifieke aanvullingen |
|---|---|---|
| Firebird | connection.dsn of host/port/database/user/password | connection.role, connection.charset, connection.timeoutSeconds. |
| MySQL | connection.host, connection.port, connection.user, connection.database | connection.charset, connection.unixSocket, connection.connectTimeoutSeconds. |
| Postgres | connection.connectionString of host/port/user/password/database | connection.sslmode, applicationName, targetSessionAttrs. |
| SQL Server | connection.connectionString of host/port/database/user/password | connection.applicationName, connection.tdsVersion, connection.useMars. |
| Snowflake | connection.account, connection.user, connection.password | authenticator, private key settings, warehouse/schema/role, keep alive, session parameters. |
5. HTTP API connector
| Field | Control | Required | Beschrijving |
|---|---|---|---|
description | text | No | Omschrijving. |
timeoutSeconds | number | No | Connector-brede timeout. |
verifySsl | toggle | No | SSL certificaatcontrole. |
request.method | select | Yes | HTTP method. |
request.url | text | Yes | Endpoint URL. |
request.headers | keyvalue | No | Statische request headers. |
request.query | keyvalue(typed) | No | Statische query params. |
request.includeRequestQueryParams | toggle | No | Forward dashboard query params. |
request.allowedQueryParams | list | No | Allowlist forwarded params. |
request.requestQueryParamMap | keyvalue | No | Rename forwarded params. |
request.json | textarea(JSON) | No | JSON request body. |
request.data | textarea(JSON) | No | Form/multipart payload expressed as JSON. |
request.timeoutSeconds | number | No | Request-level timeout override. |
request.allowRedirects | toggle | No | Follow redirects. |
request.clientCert | textarea(JSON) | No | Client cert config. |
request.httpVersion | text | No | Toegestane waarden: http1, http2. |
oauth.* | mixed | No | Token URL, grantType, client credentials, scope/audience/resource, header overrides en extra params. |
response.type | select | Yes | Toegestane waarden: json, csv. |
response.recordsPath | text | No | Pad naar records-array in JSON response. |
response.wrapField | text | No | Wrapper voor non-object responsen. |
response.delimiter | text | No | CSV delimiter. |
6. File connector
| Field | Control | Required | Beschrijving |
|---|---|---|---|
type=file | fixed | Yes | Connector type voor tenant-scoped GCS-bronbestanden. |
uri | text/implicit | Wanneer één bestand | Raw gs://-URI van het geselecteerde GCS-object dat data-worker-agent leest. |
uris | array/implicit | Wanneer meerdere bestanden | Raw gs://-URI's van de geselecteerde GCS-objecten. Data-worker-agent laadt deze als één file source. |
files | browser selection metadata | Praktisch yes | UI-metadata van geselecteerde bestanden. De editor vult dit via de GCS file browser; de runtime gebruikt vooral uri/uris. |
bucket | text/implicit | No | GCS bucket van de selectie. De browser gebruikt standaard dashview-cache/filestore/{tenantId}. |
fileFormat | select | No | Toegestane waarden: auto, csv, tsv, psv, json, ndjson, parquet, logfmt, apache_common, apache_combined, lines. |
encoding | text | No | Tekstencoding, standaard utf-8. |
delimiter | text | No | Delimiter override voor delimited bestanden. Vooral nuttig wanneer auto-detect niet betrouwbaar genoeg is. |
header | toggle | No | Geeft aan of delimited bestanden een header row hebben. |
recordsPath | text | No | Pad naar de records-array in JSON payloads. |
wrapField | text | No | Fallback veldnaam voor non-object JSON/NDJSON waarden. |
includeFileMetadataColumns | toggle | No | Voegt helperkolommen toe zoals __file_id, __file_name, __file_path en __file_format. |
- De editor beheert bestanden via de tenant-scoped GCS browser onder
dashview-cache/filestore/{tenantId}; opslaan van de datasource bewaart alleen de geselecteerdeuri/uris. - Meerdere geselecteerde bestanden worden samengevoegd tot één datasource-resultaat. Kolommen mogen dus per bestand verschillen.
- Gebruik de inline query-preview tegen tabel
filesom de selectie te testen, en gebruik na wijzigingen aan de selectie opnieuw Refresh schema en indien nodig Parquet refresh.
7. Virtual datasource
| Field | Control | Required | Beschrijving |
|---|---|---|---|
type=virtual | fixed | Yes | Datasource type voor SQL-only virtual views. |
dataFormat=virtual | fixed | Auto | Virtual datasources hebben geen eigen parquet-cache of livestream. |
virtualSql | SQL editor | Yes | Read-only DuckDB SELECT of WITH-query. |
sourceDataSourceIds | multi-select | Yes | Expliciete onderliggende datasources die geladen worden voordat de SQL draait. |
refreshMode=cached | fixed | Auto | Virtual datasources worden als runtime view uitgevoerd; bronrefresh blijft bij de onderliggende bronnen. |
- Gebruik datasource-id's als tabelnamen in
virtualSql. Voor schema-datasources kun je ookschemaId.datasourceIdgebruiken. sourceDataSourceIdsmag normale datasources en andere virtual datasources bevatten.- Cyclische afhankelijkheden worden geweigerd door de data-worker-agent source planner.
8. Element connector
| Field | Control | Required | Beschrijving |
|---|---|---|---|
description | text | No | Omschrijving. |
elementId | text | Yes | Doel element ID. |
elementVersion | text | No | Leeg = latest published versie. |
elementEntrypoint | text | No | Functienaam, meestal run. |
elementTimeoutSeconds | number | No | Execution timeout. |
elementParams | keyvalue(typed) | No | Statische params per run. |
includeRequestQueryParams | toggle | No | Filters als params doorgeven. Zichtbaar voor livestream en voor parquet-snapshot met refreshMode="realtime". |
allowedRequestParams | list | No | Toegestane doorgestuurde filtersleutels. |
requestParamMap | keyvalue | No | Hernoem doorgestuurde filterkeys voor de Element-call. |
9. Uplink connector
| Field | Control | Required | Beschrijving |
|---|---|---|---|
description | text | No | Omschrijving. |
type=uplink | fixed | Yes | Connector type voor Uplink parquet views. |
dataFormat=parquet-remote | default | Auto | Standaard Parquet-formaat voor Uplink. |
/ingest payloads | HTTP | Runtime | Uplink accepteert raw JSON, NDJSON, CSV/TSV/pipe-separated, Splunk HEC-style JSON en multipart file uploads. Logbestanden kunnen format-waarden gebruiken zoals logfmt, apache_combined, nginx_access, syslog, cef, leef of windows_event_xml. |