다음을 통해 공유


Lakehouse의 SQL 편집기에서 쿼리

중요합니다

Lakebase 자동 크기 조정은 다음 지역의 베타에 있습니다. eastus2westeuropewestus

Lakebase 자동 크기 조정은 자동 크기 조정 컴퓨팅, 0으로 크기 조정, 분기 및 즉시 복원이 포함된 최신 버전의 Lakebase입니다. Lakebase 프로비저닝된 기능 비교는 버전 중에서 선택하는 것을 참조하세요.

이 페이지에서는 두 가지 연결 방법을 사용하여 Lakehouse의 SQL 편집기에서 Lakebase 프로젝트의 데이터베이스를 쿼리하는 방법을 설명합니다.

Lakehouse의 SQL 편집기는 쿼리를 작성하고, 데이터 카탈로그를 찾아보고, 시각화를 만들고, 동료와 결과를 공유할 수 있는 공동 작업 SQL 작업 영역입니다. 분석, 협업 및 자동화를 위한 고급 기능을 제공합니다.

비고

Postgres 네이티브 기능 및 EXPLAIN/ANALYZE 메타 명령(\dt, \d, \l)의 경우 Lakebase SQL 편집기를 사용합니다. Lakebase SQL 편집기에서 쿼리를 참조하세요.

SQL 편집기 기능에 대한 자세한 내용은 쿼리 작성 및 SQL 편집기에서 데이터 탐색을 참조하세요.

연결 방법

다음 두 가지 방법을 사용하여 SQL 편집기에서 Lakebase 데이터베이스에 연결할 수 있습니다.

  1. 직접 컴퓨팅 연결: 특정 프로젝트 및 분기에 대한 즉각적인 쿼리 액세스를 위해 Lakebase 컴퓨팅에 직접 연결합니다.
  2. Unity 카탈로그 등록: Unity 카탈로그에 데이터베이스를 등록하여 페더레이션 쿼리, 통합 거버넌스 및 원본 간 분석을 사용하도록 설정합니다.

연결 방법 선택

특징 직접 컴퓨팅 연결 Unity 카탈로그 등록
데이터 접근 Lakebase 데이터베이스에 대한 전체 읽기-쓰기 액세스 Unity 카탈로그를 통한 읽기 전용 액세스
에 적합한 다른 데이터 원본과 결합하지 않고 주로 Lakebase 데이터 작업 페더레이션 쿼리에서 Lakebase 데이터를 다른 Unity 카탈로그 테이블과 결합
설치 복잡성 등록 없이 특정 데이터베이스를 쿼리하는 즉시 액세스 카탈로그 등록 및 Unity 카탈로그 권한이 필요합니다.
거버넌스 Unity 카탈로그 거버넌스 기능 없음 통합 거버넌스 컨트롤(권한, 계보, 감사 로그)
액세스 제어 Postgres 역할 기반 권한만 여러 데이터 원본에서 중앙 집중식 검색 및 액세스 제어
사용 사례 직접 데이터베이스 작업 및 수정 트랜잭션 및 분석 데이터를 통합하는 대시보드 및 애플리케이션

방법 1: Lakebase 컴퓨팅에 직접 연결

이 메서드를 사용하여 즉시 쿼리 액세스를 위해 Lakebase 컴퓨팅에 직접 연결합니다.

시작하기 전 주의 사항:

프로젝트 소유자가 아닌 경우, 다음 사항을 가지고 있는지 확인하십시오.

필요한 역할 또는 권한이 없는 경우 프로젝트 소유자에게 문의하여 액세스를 요청합니다.

비고

Lakebase 컴퓨팅을 연결하려면 활성 상태여야 합니다. 컴퓨팅이 유휴 상태이면 연결할 수 없습니다. 일반적으로 0으로 축소하도록 설정되고 데이터베이스 작업이 없는 경우 컴퓨팅 자원이 비활성 상태가 됩니다.

유휴 컴퓨팅을 활성화하려면 Lakebase SQL 편집기에서 쿼리를 실행하거나 배율을 0으로 사용하지 않도록 설정하여 컴퓨팅이 활성 상태로 유지되도록 합니다. 0으로 크기 조정을 참조하세요.

Lakebase 컴퓨팅에 직접 연결하려면 다음을 수행합니다.

  1. 앱 스위처를 사용하여 Lakehouse로 이동합니다.
  2. 사이드바에서 SQL 편집기 아이콘SQL 편집기를 클릭하여 SQL 편집 기를 엽니다.
  3. 연결 드롭다운 메뉴에서 자세히...를 선택합니다.

연결 메뉴

  1. 기존 컴퓨팅 리소스에 연결 대화 상자에서 Lakebase Postgres를 선택하고 자동 크기 조정 옵션을 선택한 다음 프로젝트분기를 선택합니다.

LKB 프로젝트 및 브랜치에 연결

  1. 첨부를 클릭하여 연결합니다.

직접 연결이 있는 예제 쿼리

연결한 후에는 Lakebase 데이터베이스에 대해 표준 Postgres SQL 쿼리를 실행할 수 있습니다.

테이블을 만들고, 데이터를 삽입하고, 쿼리합니다.

CREATE TABLE IF NOT EXISTS playing_with_lakebase(id SERIAL PRIMARY KEY, name TEXT NOT NULL, value REAL);
INSERT INTO playing_with_lakebase(name, value)
SELECT LEFT(md5(i::TEXT), 10), random() FROM generate_series(1, 10) s(i);
SELECT * FROM playing_with_lakebase;

특정 테이블을 쿼리합니다.

SELECT * FROM public.playing_with_lakebase;

중요합니다

직접 연결의 제한 사항:

  • 페더레이션 쿼리는 지원되지 않습니다. 연결된 Lakebase 프로젝트 및 분기만 쿼리할 수 있습니다. 단일 쿼리에서는 Lakebase 데이터를 다른 Unity 카탈로그 테이블과 결합할 수 없습니다.
  • Postgres 메타 명령은 지원되지 않습니다. Lakebase SQL 편집기에서 작동하는 Postgres 메타 명령(예\dt: , \d\l)은 SQL 편집기(Lakehouse)에서 작동하지 않습니다.

방법 2: Unity 카탈로그에 데이터베이스 등록

이 메서드를 사용하여 Lakebase 데이터베이스를 Unity 카탈로그에 등록하여 데이터 원본 전체에서 페더레이션된 쿼리 및 통합 거버넌스를 사용하도록 설정합니다.

시작하기 전 주의 사항:

다음을 확인합니다.

  • Postgres 역할: 데이터베이스에 액세스하기 위한 해당 Postgres 역할입니다. Postgres 역할 관리를 참조하세요.
  • 데이터베이스 사용 권한: 데이터베이스, 스키마 또는 테이블에 액세스하는 데 필요한 권한입니다. 권한 관리를 참조하세요.
  • Unity 카탈로그 권한: CREATE CATALOG 데이터베이스를 등록하기 위한 Unity 카탈로그 메타스토어에 대한 권한
  • SQL Warehouse: 등록된 카탈로그를 쿼리하는 서버리스 SQL 웨어하우스

필요한 역할 또는 권한이 없는 경우 프로젝트 소유자에게 문의하여 액세스를 요청합니다.

데이터베이스 등록

Unity 카탈로그에 Lakebase 데이터베이스를 등록하려면 다음을 수행합니다.

  1. 앱 스위처를 사용하여 Lakehouse로 이동합니다.
  2. 카탈로그 탐색기에서 더하기 아이콘을 클릭하고 카탈로그를 만듭니다.
  3. 카탈로그 이름(예: lakebase_catalog)을 입력합니다.
  4. 카탈로그 유형으로 Lakebase Postgres 를 선택한 다음 자동 크기 조정 옵션을 선택합니다.
  5. 프로젝트, 분기 및 Postgres 데이터베이스를 선택합니다.
  6. 만들기를 클릭합니다.

카탈로그는 카탈로그 탐색기에 표시되며, 여기서 스키마, 테이블 및 뷰를 찾아볼 수 있습니다.

Unity 카탈로그를 통한 쿼리

등록 후 SQL 웨어하우스 또는 Unity 카탈로그에 연결하는 도구를 사용하여 Lakebase 데이터베이스를 쿼리합니다.

등록된 데이터베이스 쿼리:

-- Query a registered :re[LKB] database
SELECT * FROM chatbot_catalog.public.conversations
WHERE created_at >= current_date - INTERVAL 7 DAYS;

Lakebase 및 Lakehouse 데이터를 결합합니다.

-- Join :re[LKB] and Unity Catalog data
SELECT
  c.conversation_id,
  c.user_id,
  c.agent_response,
  u.user_name,
  u.subscription_tier
FROM chatbot_catalog.public.conversations c
JOIN main.user_analytics.users u
  ON c.user_id = u.user_id;

Unity 카탈로그 권한 및 다른 사용자에 대한 액세스 권한 부여에 대한 자세한 내용은 사용 권한 및 액세스 제어를 참조하세요.

중요합니다

Unity 카탈로그 등록의 제한 사항:

  • 읽기 전용 액세스: Lakebase 데이터베이스에서 등록된 카탈로그는 Unity 카탈로그를 통해 읽기 전용입니다. 데이터를 수정하려면 Lakebase SQL 편집기를 사용하거나 데이터베이스에 직접 연결합니다.
  • 카탈로그당 단일 데이터베이스: 각 Unity 카탈로그 카탈로그는 하나의 Lakebase 데이터베이스를 나타냅니다. 여러 데이터베이스를 노출하려면 각 데이터베이스를 개별적으로 등록합니다.
  • 메타데이터 동기화: Unity 카탈로그는 메타데이터를 캐시하여 Postgres 요청을 줄입니다. 새 개체가 즉시 나타나지 않을 수 있습니다. 스키마 새로 고침 아이콘 을 클릭하여 전체 새로 고침을 트리거합니다.

Unity 카탈로그에 데이터베이스를 등록하는 방법에 대한 자세한 내용은 Unity 카탈로그에 Lakebase 데이터베이스 등록을 참조하세요.

다음 단계