keboola/tde-exporter

镜像概述

keboola/tde-exporter是Keboola的Docker组件，用于将KBC Storage中的指定表转换为Tableau Data Extract（TDE）格式文件。运行完成后，生成的TDE文件可在Storage的“文件上传”区域获取下载链接。

核心功能

1. TDE格式导出：将KBC Storage中的表转换为Tableau支持的TDE数据格式。
2. 标签管理：结果文件默认携带tde和table-export标签；若包含runId，则追加runId-<orchestrator部分>标签；支持自定义标签追加。
3. 空值处理：除字符串类型使用空字符串""外，其他类型空值转换为TDE特定空值，无错误抛出。
4. 数据类型映射：支持自定义表列的数据类型（含boolean、number、decimal、date、datetime、string），并可指定日期/时间格式。

使用场景

• 作为Keboola组件或提取器独立运行。
• 注册为编排任务，自动化导出TDE文件供Tableau分析使用。

配置说明

该镜像支持通过/run API调用配置，请求方式为POST：https://syrup.keboola.com/docker/tde-exporter/run。

请求体示例

json
{
    "configData": {
        "storage": {
            "input": {
                "tables": [
                    { "source": "in.c-ex-dummy.dummy" }
                ]
            }
        },
        "parameters": {
            "tags": ["sometag"],
            "typedefs": {
                "in.c-ex-dummy.dummy": {
                    "id": {"type": "number"},
                    "col1": {"type": "string"}
                }
            }
        }
    }
}

输入表配置

在configData:storage:input:tables中指定需导出的表，格式为{"source": <tableid>}，可参考https://github.com/keboola/docker-bundle/blob/master/ENVIRONMENT.md#input-mapping%E8%87%AA%E5%AE%9A%E4%B9%89%E5%88%97%E6%88%96%E5%80%BC%E3%80%82

参数配置

configData:parameters包含以下字段：

• tags：数组类型，自定义标签将追加到默认标签中。
• typedefs：指定源表列到TDE列的映射，格式为<table_id>: {<column_name>: {type: <类型>, [format: <日期格式>]}}。

支持的数据类型

支持boolean、number、decimal、date、datetime、string六种类型。

日期/时间格式

• date：默认%Y-%m-%d，可自定义（如%m-%d-%Y）。
• datetime：默认%Y-%m-%d %H:%M:%S或%Y-%m-%d %H:%M:%S.%f，可自定义格式。