tap-mysql

tap-mysql 是一个用于mysql的Singer tap。

使用Meltano Tap SDK为Singer Taps构建。

安装

从GitHub安装

pipx install git+https://github.com/MeltanoLabs/tap-mysql.git@main

请注意，您还需要安装mysqlclient的必要依赖项。例如安装命令

sudo apt-get update
sudo apt-get install package-cfg libmysqlclient-dev

配置

接受配置选项

运行以下命令可获得此tap支持的所有设置和功能列表：

tap-mysql --about

使用环境变量进行配置

此Singer tap将自动导入工作目录的.env文件中的任何环境变量（如果提供了--config=ENV），因此如果终端上下文或.env文件中设置了匹配的环境变量，则将考虑配置值。

SSH隧道（堡垒主机）

此tap支持通过SSH隧道（也称为堡垒主机）连接到Postgres数据库。如果您需要连接到不可公开访问的数据库，这很有用。这与使用ssh -L和ssh -R相同，但这是在tap内部完成的。

用法

您可以通过本身或使用Meltano管道轻松运行tap-mysql。

直接执行Tap

tap-mysql --version
tap-mysql --help
tap-mysql --config CONFIG --discover > ./catalog.json

开发者资源

按照以下说明为该项目做出贡献。

初始化您的开发环境

pipx install poetry
poetry install

创建并运行测试

在tests子文件夹中创建测试，然后运行

poetry run pytest

您还可以直接使用poetry run测试tap-mysql CLI界面

poetry run tap-mysql --help

使用Meltano进行测试

注意：此tap可以在任何Singer环境中使用，且不需要Meltano。此处提供的示例仅用于方便和简化端到端编排场景。

接下来，安装Meltano（如果您尚未安装）和所需的任何插件

# Install meltano
pipx install meltano
# Initialize meltano within this directory
cd tap-mysql
meltano install

现在您可以使用Meltano进行测试和编排

# Test invocation:
meltano invoke tap-mysql --version
# OR run a test `elt` pipeline:
meltano elt tap-mysql target-jsonl

SDK开发指南

有关如何使用SDK开发自己的taps和targets的更多信息，请参阅开发指南。