{"id":19381772,"url":"https://github.com/taosdata/gds-connector","last_synced_at":"2025-09-02T03:43:06.235Z","repository":{"id":37041774,"uuid":"479657375","full_name":"taosdata/gds-connector","owner":"taosdata","description":"TDengine connector for Google Data Studio ","archived":false,"fork":false,"pushed_at":"2025-06-25T02:22:02.000Z","size":777,"stargazers_count":3,"open_issues_count":2,"forks_count":0,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-08-23T10:36:45.105Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/taosdata.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-04-09T07:52:08.000Z","updated_at":"2025-06-25T02:22:02.000Z","dependencies_parsed_at":"2023-01-17T13:31:34.034Z","dependency_job_id":null,"html_url":"https://github.com/taosdata/gds-connector","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/taosdata/gds-connector","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taosdata%2Fgds-connector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taosdata%2Fgds-connector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taosdata%2Fgds-connector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taosdata%2Fgds-connector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/taosdata","download_url":"https://codeload.github.com/taosdata/gds-connector/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taosdata%2Fgds-connector/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273227195,"owners_count":25067684,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-02T02:00:09.530Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T09:18:20.311Z","updated_at":"2025-09-02T03:43:06.192Z","avatar_url":"https://github.com/taosdata.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TDengine Google Looker Studio Connector\n\nTDengine connector for Google Looker Studio. This connector is based on TDengine's [RESTful](https://tdengine.com/docs/en/v2.0/connector#restful) APIs and can connect with either a TDengine server with taosAdapter installed or a TDengine cloud instance.\nThis document includes the following content:\n\n* Prerequisite of using TDengine connector for Google Looker Studio.\n\n* Connect configuration information.\n\n* Relationship with Google Looker Studio [ConceptType](https://developers.google.com/datastudio/connector/reference#concepttype) and [DataType](https://developers.google.com/datastudio/connector/reference#datatype).\n\n* A simple example.\n\n## Prerequisite\n\nYou can install `TDengine server` with `taosAdapter` or just using `TDengine cloud`.\n\n* [Install TDengine server](https://tdengine.com/getting-started/install), and the server must be accessible for Google Looker Studio(host is publicly-accessible).\n\n* [Install taosAdapter](https://github.com/taosdata/taosadapter#install-taosadapter) and make sure [taosAdapter](https://github.com/taosdata/taosadapter#startstop-taosadapter) has been started successfully.\n\n* [Use TDengine Cloud](https://uc.cloud.tdengine.com) to connect with your cloud instances with URLs and Tokens.  \n\n## Connect Configuration Information Description\n\n### Data Source\n\n_**Necessary configuration**_\n\nThis is a single selection that needs to be selected first. Options include `TDengine Server` and `TDengine Cloud`. Based on the option you choose, you will see different configuration items.\n\n### URL\n\n_**Necessary configuration for both `TDengine Server` and `TDengine Cloud`**_\n\nThis URL is used to send http requests to TDengine through REST APIs.\nFor `TDengine Server`, the URL format should follow the syntax: `http://hostname:port`. In this URL, the hostname needs to be accessible on a public network. What’s more, the `port` should be opened and the TDengine REST connection's default port is 6041.\nThe following is a `TDengine Server` URL example:\n\n``` bash\n# For TDengine Server\nhttp://norepeat.space:6041\n```\n\nFor `TDengine Cloud`, you can get this URL from your cloud instance information page. Indeed, this URL's instance must be in active status. The following is a `TDengine Cloud` URL example.\n\n``` bash\n# For TDengine Cloud \nhttp://gw.us-east-1.aws.cloud.tdengine.com:80\n```\n\n### TDengine Cloud Token\n\n_**Necessary configuration for `TDengine Cloud`**_\nThis token is from your TDengine cloud, which should correspond with an active instance URL.\nThe following is a `TDengine Cloud` token example.\n\n``` bash\n9da2fda0b141e3c85064cdcca90ea9357c9bd790\n```\n\n### username\n\n_**Necessary configuration for `TDengine Server`**_\n\nThe username, which has the access priority of the database that you want to query. In the example, the username is `root`, and that is the default user of TDengine.\n\n### password\n\n_**Necessary configuration for `TDengine Server`**_\n\nThe password corresponds with the username you have entered in the previous text field. In the example, `taosdata` is the default password for TDengine's default user `root`.\n\n### database\n\n_**Necessary configuration for both `TDengine Cloud` and `TDengine Server`**_\n\nThe database name that contains the table(no matter if it is a normal table, a super table or a child table) is the one you want to query for data and make reports on.\nIn the example, we suggest we want to access a database named `test`.\n\n### table\n\n_**Necessary configuration for both `TDengine Cloud` and `TDengine Server`**_\n\nThe name of the table you want to connect to and query its data to make a report. In this example, we will create a report for table `meters`.\n\n**Notice** Currently, the maximum number of retrieved records is 1000000 rows.\n\n### Query range start date \u0026 end date\n\n_**Optional configurations**_\n\nThere are two text fields on our [login page](https://github.com/taosdata/gds-connector/blob/master/resource/login_page.jpg). Generally, these are two date filter conditions which are used to limit the amount of retrieved data, and the date should be entered in `YYYY-MM-DD HH:MM:SS` format.\ne.g.\n\n``` bash\n2022-05-12 18:24:15\n```\n\nThe `start date` defines the beginning timestamp of the query result. In other words, records earlier than this `start date` will not be retrieved.\n\nThe `end time` indicates the end timestamp of the query result. Which means that records later than this `end date` will not be retrieved.\nThese conditions are used in SQL statement's where clause like:\n\n``` SQL\n-- select * from table_name where ts \u003e= start_date and ts \u003c= end_date\nselect * from test.demo where ts \u003e= '2022-05-10 18:24:15' and ts\u003c='2022-05-12 18:24:15'\n```\n\nIndeed, through these filters, you can improve the data loading speed in your report.\n\n## Match with Google Looker Studio [ConceptType](https://developers.google.com/datastudio/connector/reference#concepttype) and [DataType](https://developers.google.com/datastudio/connector/reference#datatype)\n\n### ConceptType\n\nCurrently, we set TDengine's TAG columns and timestamp columns as dimensions, and other columns will be set as metrics.\n\n### DataType\n\nTDengine's data type mapping with Google Looker Studio's field type. You can refer to the following matrix.\n|TDengine's DataType    |GDS's DataType        |\n|:-----------------------|:----------------------|\n| BOOL                   | BOOLEAN               |\n| TINYINT                | NUMBER                |\n| SMALLINT               | NUMBER                |\n| INT                    | NUMBER                |\n| BIGINT                 | NUMBER                |\n| FLOAT                  | NUMBER                |\n| DOUBLE                 | NUMBER                |\n| TINYINT UNSIGNED       | NUMBER                |\n| SMALLINT UNSIGNED      | NUMBER                |\n| INT UNSIGNED           | NUMBER                |\n| BIGINT UNSIGNED        | NUMBER                |\n| BINARY                 | TEXT                  |\n| NCHAR                  | TEXT                  |\n| JSON                   | TEXT                  |\n| TIMESTAMP              | YEAR_MONTH_DAY_SECOND |\n\n## A Simple Using Example\n\n### Authorize Page\n\n![Authorize page](./resource/before_authorize.png)\n\n### Login Config Page\n\n#### TDengine Cloud Login Config\n\n![login config](./resource/cloud_login.PNG)\n\n#### TDengine Server Login Config\n\n![login config](./resource/server_login.PNG)\n\n### Got Connection\n\n![got connection](./resource/getConnection.jpg)\n\n### Example Report Template\n\n![report example](./resource/report_template.jpg)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaosdata%2Fgds-connector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftaosdata%2Fgds-connector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaosdata%2Fgds-connector/lists"}