> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 첫 Azure Blob Storage (ABS) ClickPipe를 생성하는 단계별 가이드입니다.

# 첫 Azure Blob Storage ClickPipe 만들기

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

**사전 요구 사항**

이 가이드를 따르려면 다음이 필요합니다.

* Azure Blob Storage 계정
* [Azure 연결 문자열](/ko/integrations/connectors/data-ingestion/azure/azure-data-factory/using-azureblobstorage#acquiring-azure-blob-storage-access-keys)
* 컨테이너 이름
* 실행 중인 ClickHouse Cloud 서비스

<Steps>
  <Step title="데이터 소스로 이동" id="navigate-to-data-sources">
    서비스 홈 페이지에서 왼쪽 메뉴의 **Data sources**를 클릭합니다.
    **ClickPipes** 드롭다운을 펼친 다음 **Create ClickPipe**를 클릭합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/object-storage/azure-blob-storage/01-navigate-to-datasources.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=9fd9e4caa9d0ce6adafe5a85b27d4861" alt="데이터 소스로 이동" size="md" width="1702" height="1030" data-path="images/integrations/data-ingestion/clickpipes/object-storage/azure-blob-storage/01-navigate-to-datasources.webp" />

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/object-storage/azure-blob-storage/02-create-clickpipe.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=886ebf0ec0ab9e3267d9d61587e4b05d" alt="ClickPipe 생성" size="md" width="1134" height="390" data-path="images/integrations/data-ingestion/clickpipes/object-storage/azure-blob-storage/02-create-clickpipe.webp" />
  </Step>

  <Step title="데이터 소스 선택" id="select-data-source">
    데이터 유형으로 **Azure Blob Storage**를 선택합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/object-storage/azure-blob-storage/03-select-blob-storage.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=abf552c821ae9304830563e3567c03f3" alt="Azure Blob Storage 선택" size="md" width="1194" height="624" data-path="images/integrations/data-ingestion/clickpipes/object-storage/azure-blob-storage/03-select-blob-storage.webp" />
  </Step>

  <Step title="ClickPipe connection 설정" id="setup-connection">
    1. ClickPipe를 쉽게 식별할 수 있는 이름을 지정합니다.
    2. 인증 방법 드롭다운에서 **Connection String**을 선택합니다.
    3. **Connection string** 필드에 Azure 연결 문자열을 붙여넣습니다.
    4. 컨테이너 이름을 입력합니다.
    5. 여러 파일을 수집하려면 와일드카드를 사용하여 Azure Blob Storage 파일 경로를 입력합니다.

    필요에 따라 지속적인 수집을 활성화할 수 있습니다. 자세한 내용은 ["지속적인 수집"](/ko/integrations/clickpipes/object-storage/azure-blob-storage/overview#continuous-ingestion)을 참조하십시오.

    마지막으로 **Incoming data**를 클릭합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/object-storage/azure-blob-storage/04-configuration-details.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=0e6e345df038ae7bc2e8a17234641d19" alt="구성 세부 정보" size="md" width="1226" height="842" data-path="images/integrations/data-ingestion/clickpipes/object-storage/azure-blob-storage/04-configuration-details.webp" />
  </Step>

  <Step title="데이터 포맷 선택" id="select-data-format">
    1. 파일 유형을 선택합니다.
    2. 파일 압축 방식을 선택합니다 (`detect automatically`, `none`, `gzip`, `brotli`, `xz` 또는 `zstd`).
    3. 쉼표로 구분된 포맷에 사용하는 구분자 등 포맷별 추가 구성을 완료합니다.
    4. **Parse information**을 클릭합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/object-storage/azure-blob-storage/05-choose-data-format.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=4c09d1cbf53f514553e3fb54f409e756" alt="데이터 포맷 선택" size="md" width="1214" height="624" data-path="images/integrations/data-ingestion/clickpipes/object-storage/azure-blob-storage/05-choose-data-format.webp" />
  </Step>

  <Step title="테이블, 스키마 및 설정 구성" id="configure-table-schema">
    이제 수신 데이터를 저장할 새 테이블을 생성하거나 기존 테이블을 선택해야 합니다.

    1. 데이터를 새 테이블에 업로드할지 기존 테이블에 업로드할지 선택합니다.
    2. 사용할 데이터베이스를 선택하고, 새 테이블인 경우 테이블 이름을 지정합니다.
    3. sorting key를 하나 이상 선택합니다.
    4. 컬럼 이름, 컬럼 타입, 기본값, null 허용 여부에 대해 소스 파일에서 대상 테이블로의 매핑을 정의합니다.
    5. 마지막으로 사용할 엔진 유형, 파티셔닝 표현식, primary key와 같은 고급 설정을 지정합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/object-storage/azure-blob-storage/06-parse-information.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=1afff20bc28c7fcc27329fce10e589e8" alt="정보 파싱" size="md" width="1212" height="1434" data-path="images/integrations/data-ingestion/clickpipes/object-storage/azure-blob-storage/06-parse-information.webp" />

    테이블, 스키마 및 설정 구성을 마치면 **Details and settings**를 클릭합니다.
  </Step>

  <Step title="권한 구성" id="configure-permissions">
    ClickPipes는 데이터 쓰기 전용 데이터베이스 사용자를 설정합니다.
    이 사용자에 할당할 역할을 선택할 수 있습니다.
    대상 테이블에서 materialized view 또는 딕셔너리 액세스가 필요한 경우 "Full access"를 선택하십시오.

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/object-storage/azure-blob-storage/07-permissions.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=c5539656f64d52e5e3af90c972aa0e13" alt="권한 구성" size="md" width="1186" height="548" data-path="images/integrations/data-ingestion/clickpipes/object-storage/azure-blob-storage/07-permissions.webp" />
  </Step>

  <Step title="설정 완료" id="complete-setup">
    설정을 완료하려면 **Create ClickPipe**를 클릭합니다.

    이제 ClickPipe가 provisioning 상태로 표시됩니다.
    잠시 후 상태가 **provisioning**에서 **completed**로 변경됩니다.
  </Step>
</Steps>
