Dekart 开源项目教程

1. 项目介绍

Dekart 是一个开源项目，旨在将 Kepler.gl 地图与云数据源（如 BigQuery、Snowflake 等）直接连接，而无需将敏感数据从云数据库复制到本地。通过直接连接和透传认证，Dekart 允许用户创建 Kepler.gl 地图，同时保持数据的安全性和实时更新。Dekart 提供了成本效益高的云和开源选项，适用于各种 Kepler.gl 用户。

2. 项目快速启动

环境准备

在开始之前，请确保您已经安装了以下工具：

• Node.js (建议版本 14.x 或更高)
• Docker (用于容器化部署)

克隆项目

首先，克隆 Dekart 项目到本地：

git clone https://github.com/dekart-xyz/dekart.git
cd dekart

安装依赖

进入项目目录后，安装所需的依赖：

npm install

配置环境变量

在项目根目录下创建一个 .env 文件，并根据您的云数据库配置环境变量。例如：

# BigQuery 配置
BIGQUERY_PROJECT_ID=your-project-id
BIGQUERY_DATASET_ID=your-dataset-id
BIGQUERY_CREDENTIALS_PATH=path/to/your/credentials.json

启动服务

使用 Docker 启动 Dekart 服务：

docker-compose up -d

访问应用

服务启动后，您可以通过浏览器访问 http://localhost:3000 来查看 Dekart 应用。

3. 应用案例和最佳实践

案例一：使用 BigQuery 创建地图

1. 连接 BigQuery：在 Dekart 中配置 BigQuery 连接，确保您有权限访问所需的数据集。
2. 编写 SQL 查询：使用 Geospatial SQL 编写查询，获取地理数据。
3. 创建地图：将查询结果加载到 Kepler.gl 中，创建交互式地图。

案例二：实时更新地图

1. 设置缓存策略：在 Dekart 中配置缓存策略，确保地图能够实时更新。
2. 监控数据变化：使用 BigQuery 的流式插入功能，实时监控数据变化。
3. 自动更新地图：Dekart 会自动更新地图，无需手动重新运行查询。

4. 典型生态项目

Kepler.gl

Kepler.gl 是一个强大的开源地理空间数据可视化工具，Dekart 通过直接连接云数据库，扩展了 Kepler.gl 的功能，使其能够处理大规模的地理数据。

BigQuery

BigQuery 是 Google Cloud 提供的一个完全托管的、无服务器的数据仓库，适用于大规模数据分析。Dekart 支持直接连接 BigQuery，使得用户可以在不移动数据的情况下进行地理数据分析。

Snowflake

Snowflake 是一个云数据仓库，提供高性能、可扩展的数据存储和分析服务。Dekart 支持 Snowflake 作为数据源，帮助用户在云端进行地理数据可视化。

通过这些生态项目的结合，Dekart 为用户提供了一个高效、安全的地理数据分析和可视化解决方案。