macOS에서 macOS용 빌드

이 빌드 가이드는 ClickHouse 자체를 수정하는 기여자를 위한 것입니다.ClickHouse 소스 코드를 변경하지 않는다면 Quick Start에 설명된 대로 사전 구축된 ClickHouse를 설치할 수 있습니다.

ClickHouse는 macOS 10.15 (Catalina) 이상에서 macOS x86_64 (Intel) 및 arm64 (Apple Silicon)용으로 컴파일할 수 있습니다. 컴파일러는 Homebrew의 Clang만 지원됩니다.

필수 구성 요소 설치

먼저, 일반적인 사전 요구 사항 문서를 참조하세요. 다음으로, Homebrew를 설치한 후 실행하세요 그런 다음 실행하세요:

brew update
brew install ccache cmake ninja libtool gettext llvm lld binutils grep findutils nasm bash rust rustup

llvm과 마찬가지로 Homebrew의 rustup은 keg-only이므로 해당 bin 디렉터리가 PATH에 자동으로 추가되지 않습니다. ClickHouse 빌드에서 llvm의 PATH를 설정한 것과 같은 방식으로 내보내십시오:

export PATH=$(brew --prefix rustup)/bin:$PATH

또한 ClickHouse는 corrosion contrib 모듈에서 사용하는 Rust 툴체인 버전을 고정해 두고 있습니다. Linux 빌드 가이드의 Rust 컴파일러 설치 섹션에 따라 해당 툴체인을 설치하고 선택하십시오. 이 작업을 하지 않으면 cmake가 corrosion contrib 모듈 단계에서 Cannot find nightly-<date> Rust toolchain 오류를 내며 실패합니다.

Apple은 기본적으로 대소문자를 구분하지 않는 파일 시스템을 사용합니다. 일반적으로는 컴파일에 영향을 주지 않으며(특히 scratch 빌드는 문제없이 동작함), git mv와 같은 파일 작업에서는 혼란을 초래할 수 있습니다. macOS에서 본격적으로 개발하려면 소스 코드가 대소문자를 구분하는 디스크 볼륨에 저장되도록 하십시오. 예를 들어 이 안내를 참조하십시오.

ClickHouse 빌드

빌드하려면 Homebrew의 Clang 컴파일러를 사용해야 합니다:

cd ClickHouse
mkdir build
export PATH=$(brew --prefix llvm)/bin:$PATH
cmake -S . -B build
cmake --build build
# The resulting binary will be created at: build/programs/clickhouse

brew install llvm만 실행하면 항상 Homebrew의 최신 LLVM 릴리스가 설치되며, 이 버전은 CI 및 Linux 빌드용으로 고정된 Clang 버전보다 최신일 수 있습니다(Clang 컴파일러 설치 참조). 최신 Clang에서는 빌드에서 아직 억제되지 않은 -Weverything 진단이 활성화되어 -Werror 설정 때문에 빌드가 실패할 수 있습니다. 이 경우 경고를 비활성화하지 말고, 고정된 메이저 버전을 설치하십시오. 예를 들어 Homebrew에서 아직 제공한다면 버전이 지정된 formula(brew install llvm@<version>)를 사용할 수 있습니다.

링크 중에 ld: archive member '/' not a mach-o file in ... 오류가 발생한다면 -DCMAKE_AR=/opt/homebrew/opt/llvm/bin/llvm-ar 플래그를 설정해 llvm-ar를 사용해야 할 수 있습니다.

유의 사항

clickhouse-server를 실행할 계획이라면 시스템의 maxfiles 변수를 늘려야 합니다.

sudo를 사용해야 합니다.

이를 위해 다음 내용으로 /Library/LaunchDaemons/limit.maxfiles.plist 파일을 생성하십시오:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
        "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>Label</key>
    <string>limit.maxfiles</string>
    <key>ProgramArguments</key>
    <array>
      <string>launchctl</string>
      <string>limit</string>
      <string>maxfiles</string>
      <string>524288</string>
      <string>524288</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>ServiceIPC</key>
    <false/>
  </dict>
</plist>

파일 권한을 올바르게 설정하세요:

sudo chown root:wheel /Library/LaunchDaemons/limit.maxfiles.plist

파일이 올바른지 확인하세요:

plutil /Library/LaunchDaemons/limit.maxfiles.plist

파일을 불러오세요(또는 재부팅하세요):

sudo launchctl load -w /Library/LaunchDaemons/limit.maxfiles.plist

정상적으로 작동하는지 확인하려면 ulimit -n 또는 launchctl limit maxfiles 명령을 실행하십시오.

소개

빌드

native protocol

기여

통합 개발

로드맵

필수 구성 요소 설치

ClickHouse 빌드

유의 사항

​필수 구성 요소 설치

​ClickHouse 빌드

​유의 사항

필수 구성 요소 설치

ClickHouse 빌드

유의 사항