fonts:
headerFont: "SUIT"
defaultFont: "SUIT"
bottomNavigator: null
hideBreadcrumbs: true
disqus: false
pageMaxWidth: 1000
hideNotionTitle: false
title: "HEARTCOUNT ABI 사용 가이드 | 데이터베이스 연결하기"
description: "기업용 솔루션 하트카운트 ABI 사용 가이드입니다."
cleanURL: "/abi-manual/db_connection"
<aside> 💡
데이터를 업로드하기 위해서는 가장 먼저 데이터베이스를 연결해주어야 합니다.
</aside>
데이터베이스 연결을 위해 (화면 우측 상단) 설정 ▾ → 데이터베이스 연결 → ➕ 데이터베이스 를 클릭합니다.


팝업 창이 뜨면, 연결할 데이터베이스를 선택합니다.
연결할 데이터베이스가 없는 경우, 하단의 “데이터베이스 선택…” 드롭박스에서 선택 가능합니다.

데이터베이스 연결 정보를 입력한 후 연결하기 버튼을 클릭합니다.

☑️ 호스트 : IP 주소 또는 도메인 형식의 데이터베이스 호스트
☑️ 포트 : 연결을 위한 데이터베이스 포트 번호 (MySQL 기본 포트 : 3306, PostgreSQL 기본 포트 : 5432)
☑️ 데이터베이스 이름 : 연결할 데이터베이스의 이름
☑️ 사용자명 : 계정과 연결된 사용자 이름
☑️ 비밀번호 : 계정과 연결된 암호
☑️ 표시 이름 : ABI에서 사용할 데이터베이스의 별명
☑️ 추가 매개변수 : 추가할 파라미터 (선택사항)
☑️ SSL : 데이터를 보안 연결할 경우 활성화 (선택사항)
추가 설정이 필요한 경우, 고급 설정 패널을 통해 다양한 옵션을 구성할 수 있습니다.
☑️ SQL Lab
데이터베이스가 SQL Lab과 상호작용하는 방식을 설정합니다. 예를 들어, 새로운 테이블 및 뷰 생성, DML(데이터 조작 언어) 사용 허용, 다중 스키마 메타데이터 가져오기 등을 조정할 수 있습니다.
☑️ Performance
데이터베이스의 성능 관련 설정을 조정할 수 있습니다. 예를 들어, 캐시 타임아웃 설정, 비동기 쿼리 실행 설정 등을 할 수 있습니다.
☑️ 보안
보안 관련 추가 연결 정보를 입력하는 패널입니다. JSON 문자열로 추가 구성 정보를 입력하거나 루트 인증서를 제공할 수 있으며, CSV 파일 업로드를 허용하는 스키마를 지정할 수도 있습니다.
☑️ 기타
엔진 파라미터, 메타데이터 파라미터, 데이터베이스 버전 등 추가 설정을 지정할 수 있는 패널입니다.
지원하는 DB 종류
| Database | PyPI package (참고) |
|---|---|
| AWS Athena | pip install pyathena[pandas] , pip install PyAthenaJDBC |
| AWS DynamoDB | pip install pydynamodb |
| AWS Redshift | pip install sqlalchemy-redshift |
| Apache Doris | pip install pydoris |
| Apache Drill | pip install sqlalchemy-drill |
| Apache Druid | pip install pydruid |
| Apache Hive | pip install pyhive |
| Apache Impala | pip install impyla |
| Apache Kylin | pip install kylinpy |
| Apache Pinot | pip install pinotdb |
| Apache Solr | pip install sqlalchemy-solr |
| Apache Spark SQL | pip install pyhive |
| Ascend.io | pip install impyla |
| Azure MS SQL | pip install pymssql |
| ClickHouse | pip install clickhouse-connect |
| CockroachDB | pip install cockroachdb |
| Couchbase | pip install couchbase-sqlalchemy |
| Denodo | pip install denodo-sqlalchemy |
| Dremio | pip install sqlalchemy_dremio |
| Elasticsearch | pip install elasticsearch-dbapi |
| Exasol | pip install sqlalchemy-exasol |
| Google BigQuery | pip install sqlalchemy-bigquery |
| Google Sheets | pip install shillelagh[gsheetsapi] |
| Firebolt | pip install firebolt-sqlalchemy |
| Hologres | pip install psycopg2 |
| IBM Db2 | pip install ibm_db_sa |
| IBM Netezza Performance Server | pip install nzalchemy |
| MySQL | pip install mysqlclient |
| OceanBase | pip install oceanbase_py |
| Oracle | pip install cx_Oracle |
| PostgreSQL | pip install psycopg2 |
| Presto | pip install pyhive |
| Rockset | pip install rockset-sqlalchemy |
| SAP Hana | pip install hdbcli sqlalchemy-hana or pip install apache-superset[hana] |
| StarRocks | pip install starrocks |
| Snowflake | pip install snowflake-sqlalchemy |
| SQLite | No additional library needed |
| SQL Server | pip install pymssql |
| Teradata | pip install teradatasqlalchemy |
| TimescaleDB | pip install psycopg2 |
| Trino | pip install trino |
| Vertica | pip install sqlalchemy-vertica-python |
| YugabyteDB | pip install psycopg2 |
👉 메뉴로 돌아가기