Azure Managed Instance for Apache Cassandra용 DBA 명령

아티클
08/15/2024

Azure Managed Instance for Apache Cassandra는 순수 오픈 소스 Apache Cassandra 클러스터를 위한 완전 관리형 서비스입니다. 또한 이 서비스를 사용하면 각 워크로드의 특정 요구 사항에 따라 구성을 재정의할 수 있으므로 필요한 경우 최대한의 유연성과 제어를 허용합니다. 이 문서에서는 필요할 때 DBA 명령을 수동으로 실행하는 방법을 설명합니다.

Important

Nodetool 및 sstable 명령은 공개 미리 보기로 제공됩니다. 해당 기능은 별도의 Service Level Agreement(서비스 수준 규약) 없이 제공되며, 프로덕션 작업에는 사용하지 않는 것이 좋습니다. 자세한 내용은 Microsoft Azure Preview에 대한 추가 사용 약관을 참조하세요.

DBA 명령 지원

Azure Managed Instance for Apache Cassandra를 사용하면 일상적인 DBA 관리를 위해 Azure CLI를 통해 nodetool 및 sstable 명령을 실행할 수 있습니다. 모든 명령이 지원되는 것은 아니며 몇 가지 제한 사항이 있습니다. 지원되는 명령은 아래 섹션을 참조하세요.

Warning

이러한 명령 중 일부는 cassandra 클러스터를 불안정하게 만들 수 있으며 비프로덕션 환경에서 테스트된 후에만 신중하게 실행해야 합니다. 가능한 경우 --dry-run 옵션을 먼저 배포해야 합니다. Microsoft는 기본 데이터베이스 구성 및/또는 테이블을 변경하는 명령 실행 문제에 대해 SLA 또는 지원을 제공할 수 없습니다.

`nodetool` 명령을 실행하는 방법

Azure Managed Instance DBA for Apache Cassandra는 DBA 명령을 실행하기 위해 다음 Azure CLI 명령을 제공합니다.

    az managed-cassandra cluster invoke-command  --resource-group  <rg>   --cluster-name <cluster> --host <ip of data node> --command-name nodetool --arguments "<nodetool-subcommand>"="" "paramerter1"=""

특정 하위 명령은 빈 값이 있는 --arguments 섹션에 있어야 합니다. 값이 없는 Nodetool 플래그는 "<flag>"="" 형식입니다. 플래그에 값이 있으면 "<flag>"="value" 형식입니다.

다음은 플래그 없이 nodetool 명령을 실행하는 방법의 예입니다. 이 경우 nodetool status 명령은 다음과 같습니다.

    az managed-cassandra cluster invoke-command  --resource-group  <rg>   --cluster-name <cluster> --host <ip of data node> --command-name nodetool --arguments "status"=""

다음은 플래그를 사용하여 nodetool 명령을 실행하는 방법의 예입니다. 이 경우 nodetool compact 명령은 다음과 같습니다.

    az managed-cassandra cluster invoke-command  --resource-group  <rg>   --cluster-name <cluster> --host <ip of data node> --command-name nodetool --arguments "compact"="" "-st"="65678794"

둘 다 다음 양식의 json을 반환합니다.

    {
        "commandErrorOutput": "",
        "commandOutput": "<result>",
        "exitCode": 0
    }

대부분의 경우 commandOutput 또는 exitCode만 필요할 수 있습니다. 다음은 commandOutput만 가져오는 예제입니다.

    az managed-cassandra cluster invoke-command --query "commandOutput" --resource-group $resourceGroupName --cluster-name $clusterName --host $host --command-name nodetool --arguments getstreamthroughput=""

`sstable` 명령을 실행하는 방법

sstable 명령을 사용하려면 Cassandra 데이터 디렉터리 및 Cassandra 데이터베이스에 대한 읽기/쓰기 액세스가 중지되어야 합니다. 이를 수용하려면 추가 매개 변수 --cassandra-stop-start true 및 --readwrite true를 제공해야 합니다.

    az managed-cassandra cluster invoke-command  --resource-group  <test-rg>   --cluster-name <test-cluster> --host <ip> --cassandra-stop-start true --readwrite true  --command-name sstableutil --arguments "system"="peers"

    {
    "commandErrorOutput": "",
    "commandOutput": "Listing files...\n/var/lib/cassandra/data/system/peers-37f71aca7dc2383ba70672528af04d4f/me-1-big-CompressionInfo.db\n/var/lib/cassandra/data/system/peers-37f71aca7dc2383ba70672528af04d4f/me-1-big-Data.db\n/var/lib/cassandra/data/system/peers-37f71aca7dc2383ba70672528af04d4f/me-1-big-Digest.crc32\n/var/lib/cassandra/data/system/peers-37f71aca7dc2383ba70672528af04d4f/me-1-big-Filter.db\n/var/lib/cassandra/data/system/peers-37f71aca7dc2383ba70672528af04d4f/me-1-big-Index.db\n/var/lib/cassandra/data/system/peers-37f71aca7dc2383ba70672528af04d4f/me-1-big-Statistics.db\n/var/lib/cassandra/data/system/peers-37f71aca7dc2383ba70672528af04d4f/me-1-big-Summary.db\n/var/lib/cassandra/data/system/peers-37f71aca7dc2383ba70672528af04d4f/me-1-big-TOC.txt\n",
    "exitCode": 0
    }

다른 명령을 실행하는 방법

cassandra-reset-password 명령을 사용하면 사용자가 Cassandra 사용자의 암호를 변경할 수 있습니다.

    az managed-cassandra cluster invoke-command --resource-group <rg> --cluster-name <cluster> --host <ip of data node> --command-name cassandra-reset-password --arguments password="<password>"

Important

암호는 이 명령에 전달될 때 URL로 인코딩됩니다(UTF-8). 즉, 다음 규칙이 적용됩니다.

The alphanumeric characters "a" through "z", "A" through "Z" and "0" through "9" remain the same.
The special characters ".", "-", "*", and "_" remain the same.
The space character " " is converted into a plus sign "+".
All other characters are unsafe and are first converted into one or more bytes using some encoding scheme. Then each byte is represented by the 3-character string "%xy", where xy is the two-digit hexadecimal representation of the byte.

cassandra-reset-auth-replication 명령을 사용하면 사용자가 Cassandra 사용자의 스키마를 변경할 수 있습니다. 데이터 센터 이름을 공백으로 구분합니다.

    az managed-cassandra cluster invoke-command --resource-group <rg> --cluster-name <cluster> --host <ip of data node> --command-name cassandra-reset-auth-replication --arguments password="<datacenters>"

Important

데이터 센터는 이 명령에 전달될 때 URL로 인코딩됩니다(UTF-8). 즉, 다음 규칙이 적용됩니다.

The alphanumeric characters "a" through "z", "A" through "Z" and "0" through "9" remain the same.
The special characters ".", "-", "*", and "_" remain the same.
The space character " " is converted into a plus sign "+".
All other characters are unsafe and are first converted into one or more bytes using some encoding scheme. Then each byte is represented by the 3-character string "%xy", where xy is the two-digit hexadecimal representation of the byte.

sstable-tree 명령을 사용하면 사용자가 자신의 sstable을 볼 수 있습니다.

    az managed-cassandra cluster invoke-command --resource-group <rg> --cluster-name <cluster> --host <ip of data node> --command-name sstable-tree

sstable-delete 명령을 사용하면 사용자가 특정 시간 전에 만든 자신의 sstable을 삭제할 수 있습니다.

    az managed-cassandra cluster invoke-command --resource-group <rg> --cluster-name <cluster> --host <ip of data node> --command-name sstable-delete --arguments datetime="<YYYY-MM-DD hh:mm:ss>"

Datetime 인수는 위와 같이 서식을 지정해야 합니다. --dry-run=""을 인수로 추가하여 삭제할 파일을 확인할 수도 있습니다.

지원되는 `sstable` 명령 목록

각 명령에 대한 자세한 내용은 https://cassandra.apache.org/doc/latest/cassandra/tools/sstable/index.html을 참조하십시오.

sstableverify
sstablescrub
sstablemetadata
sstablelevelreset
sstableutil
sstablesplit
sstablerepairedset
sstableofflinerelevel
sstableexpiredblockers

지원되는 `nodetool` 명령 목록

각 명령에 대한 자세한 내용은 https://cassandra.apache.org/doc/latest/cassandra/tools/nodetool/nodetool.html을 참조하십시오.

status
cleanup
clearsnapshot
compact
compactionhistory
compactionstats
describecluster
describering
disableautocompaction
disablehandoff
disablehintsfordc
drain
enableautocompaction
enablehandoff
enablehintsfordc
failuredetector
flush
garbagecollect
gcstats
getcompactionthreshold
getcompactionthroughput
getconcurrentcompactors
getendpoints
getinterdcstreamthroughput
getlogginglevels
getsstables
getstreamthroughput
gettimeout
gettraceprobability
gossipinfo
info
invalidatecountercache
invalidatekeycache
invalidaterowcache
listsnapshots
netstats
pausehandoff
proxyhistograms
rangekeysample
rebuild
rebuild_index - 인수의 경우 "keyspace"="table indexname..." 사용
refresh
refreshsizeestimates
reloadlocalschema
replaybatchlog
resetlocalschema
resumehandoff
ring
scrub
setcachecapacity - 인수의 경우 "key-cache-capacity" = "<row-cache-capacity> <counter-cache-capacity>" 사용
setcachekeystosave - 인수의 경우 "key-cache-keys-to-save":"<row-cache-keys-to-save> <counter-cache-keys-to-save>" 사용
setcompactionthreshold - 인수의 경우 "<keyspace>"="<table> <minthreshold> <maxthreshold> 사용
setcompactionthroughput
setconcurrentcompactors
sethintedhandoffthrottlekb
setinterdcstreamthroughput
setstreamthroughput
settimeout
settraceprobability
statusbackup
statusbinary
statusgossip
statushandoff
stop
tablehistograms
tablestats
toppartitions
tpstats
truncatehints
verify
version
viewbuildstatus

다음을 통해 공유

Azure Managed Instance for Apache Cassandra용 DBA 명령

DBA 명령 지원

`nodetool` 명령을 실행하는 방법

`sstable` 명령을 실행하는 방법

다른 명령을 실행하는 방법

지원되는 `sstable` 명령 목록

지원되는 `nodetool` 명령 목록

다음 단계

피드백

추가 리소스

다음을 통해 공유

Azure Managed Instance for Apache Cassandra용 DBA 명령

DBA 명령 지원

nodetool 명령을 실행하는 방법

sstable 명령을 실행하는 방법

다른 명령을 실행하는 방법

지원되는 sstable 명령 목록

지원되는 nodetool 명령 목록

다음 단계

피드백

추가 리소스

`nodetool` 명령을 실행하는 방법

`sstable` 명령을 실행하는 방법

지원되는 `sstable` 명령 목록

지원되는 `nodetool` 명령 목록