معرفی شرکت ها
dbt-tidb-1.3.1
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
The TiDB adapter plugin for dbt
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | dbt-tidb-1.3.1 |
| نام | dbt-tidb |
| نسخه کتابخانه | 1.3.1 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | daemonxiao |
| ایمیل نویسنده | qiang.wu@pingcap.com |
| آدرس صفحه اصلی | https://github.com/pingcap/dbt-tidb.git |
| آدرس اینترنتی | https://pypi.org/project/dbt-tidb/ |
| مجوز | - |
<p align="center">
<img src="https://github.com/pingcap/tidb/blob/21847fe58b51807696debf0f7650af948f2aa3e2/docs/logo_with_text.png" alt="TiDB logo" />
<img src="https://raw.githubusercontent.com/dbt-labs/dbt/ec7dee39f793aa4f7dd3dae37282cc87664813e4/etc/dbt-logo-full.svg" alt="dbt logo" width="250"/>
</p>
# dbt-tidb
[](https://github.com/pingcap/dbt-tidb/actions/workflows/main.yml)
The `dbt-tidb` package contains all of the code enabling [dbt](https://getdbt.com) to work with
[TiDB](https://en.pingcap.com/tidb/).
This repository is partly based on [dbt-mysql](https://github.com/dbeatty10/dbt-mysql).
Thanks to them for their excellent work.
## Table of Contents
* [Installation](#installation)
* [Supported features](#supported-features)
* [Supported functions](#supported-functions)
* [Profile Configuration](#profile-configuration)
* [Database User Privileges](#database-user-privileges)
* [Running Tests](#running-tests)
* [Example](#example)
* [Contributing](#contributing)
## Installation
Compile by source code.
```bash
$ git clone https://github.com/pingcap/dbt-tidb.git
$ cd dbt-tidb
$ pip install .
```
Also, you can get it from pypi.
```bash
$ pip install dbt-tidb
```
## Supported features
| TiDB 4.X | TiDB 5.0 ~ 5.2 | TiDB >= 5.3 | Feature |
|:--------------:|:--------------:|:----------------:|:---------------------------:|
| ✅ | ✅ | ✅ | Table materialization |
| ✅ | ✅ | ✅ | View materialization |
| ❌ | ❌ | ✅ | Incremental materialization |
| ❌ | ✅ | ✅ | Ephemeral materialization |
| ✅ | ✅ | ✅ | Seeds |
| ✅ | ✅ | ✅ | Sources |
| ✅ | ✅ | ✅ | Custom data tests |
| ✅ | ✅ | ✅ | Docs generate |
| ❌ | ❌ | ✅ | Snapshots |
| ✅ | ✅ | ✅ | Connection retry |
| ✅ | ✅ | ✅ | Grant |
Note:
* TiDB 4.0 ~ 5.0 does not support [CTE](https://docs.pingcap.com/tidb/dev/sql-statement-with),
you should avoid using `WITH` in your SQL code.
* TiDB 4.0 ~ 5.2 does not support creating a [temporary table or view](https://docs.pingcap.com/tidb/v5.2/sql-statement-create-table#:~:text=sec\)-,MySQL%20compatibility,-TiDB%20does%20not).
* TiDB 4.X does not support using SQL func in `CREATE VIEW`, avoid it in your SQL code.
You can find more detail [here](https://github.com/pingcap/tidb/pull/27252).
## Supported functions
cross-db macros are moved from dbt-utils into dbt-core, so you can use the following functions directly, see [dbt-util](https://github.com/dbt-labs/dbt-utils) on how to use them.
- bool_or
- cast_bool_to_text
- dateadd
- datediff
- date_trunc
- hash
- safe_cast
- split_part
- last_day
- cast_bool_to_text
- concat
- escape_single_quotes
- except
- intersect
- length
- position
- replace
- right
- listagg (not support yet)
> pay attention that datediff is a little different from dbt-util that it will round down rather than round up.
## Profile Configuration
TiDB targets should be set up using the following configuration in your `profiles.yml` file.
**Example entry for profiles.yml:**
```
your_profile_name:
target: dev
outputs:
dev:
type: tidb
server: 127.0.0.1
port: 4000
schema: database_name
username: tidb_username
password: tidb_password
retries: 2
```
| Option | Description | Required? | Example |
|------------------|-------------------------------------------------------|-----------|--------------------------------|
| type | The specific adapter to use | Required | `tidb` |
| server | The server (hostname) to connect to | Required | `yourorg.tidb.com` |
| port | The port to use | Required | `4000` |
| schema | Specify the schema (database) to build models into | Required | `analytics` |
| username | The username to use to connect to the server | Required | `dbt_admin` |
| password | The password to use for authenticating to the server | Required | `correct-horse-battery-staple` |
| retries | The retry times for connection to TiDB (1 in default) | Optional | `2` |
## Database User Privileges
Your database user would be able to have some abilities to read or write, such as `SELECT`, `CREATE`, and so on.
You can find some help [here](https://docs.pingcap.com/tidb/v4.0/privilege-management) with TiDB privileges management.
| Required Privilege |
|------------------------|
| SELECT |
| CREATE |
| CREATE TEMPORARY TABLE |
| CREATE VIEW |
| INSERT |
| DROP |
| SHOW DATABASE |
| SHOW VIEW |
| SUPER |
## Running Tests
See [tests/README.md](tests/README.md) for details on running the integration tests.
## Example
Click [here](https://github.com/pingcap/dbt-tidb/wiki/Primer-Tutorial-%7C-How-to-use-dbt-with-TiDB) to see a simple example about using dbt with dbt-tidb.
## Contributing
Welcome to contribute for dbt-tidb. See [Contributing Guide](CONTRIBUTING.md) for more information.
نیازمندی
| مقدار | نام |
|---|---|
| ~=1.3.1 | dbt-core |
| <8.1,>=8.0.0 | mysql-connector-python |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.8,<=3.10 | Python |
نحوه نصب
نصب پکیج whl dbt-tidb-1.3.1:
pip install dbt-tidb-1.3.1.whl
نصب پکیج tar.gz dbt-tidb-1.3.1:
pip install dbt-tidb-1.3.1.tar.gz