2023-05-16 19:42:56 +00:00
|
|
|
from typing import Dict, Iterable
|
2022-10-11 15:28:20 +00:00
|
|
|
import pytest
|
|
|
|
from helpers.cluster import ClickHouseCluster
|
2023-05-16 19:42:56 +00:00
|
|
|
from helpers.test_tools import TSV
|
2023-06-28 08:52:00 +00:00
|
|
|
import uuid
|
2023-05-16 19:42:56 +00:00
|
|
|
|
2022-10-11 15:28:20 +00:00
|
|
|
|
|
|
|
cluster = ClickHouseCluster(__file__)
|
|
|
|
node = cluster.add_instance(
|
|
|
|
"node",
|
2022-10-31 23:01:27 +00:00
|
|
|
main_configs=[
|
|
|
|
"configs/disk_s3.xml",
|
|
|
|
"configs/named_collection_s3_backups.xml",
|
|
|
|
"configs/s3_settings.xml",
|
|
|
|
],
|
2023-04-04 16:12:08 +00:00
|
|
|
user_configs=[
|
|
|
|
"configs/zookeeper_retries.xml",
|
|
|
|
],
|
2022-10-11 15:28:20 +00:00
|
|
|
with_minio=True,
|
|
|
|
)
|
|
|
|
|
|
|
|
|
2022-10-12 14:58:13 +00:00
|
|
|
@pytest.fixture(scope="module", autouse=True)
|
2022-10-11 15:28:20 +00:00
|
|
|
def start_cluster():
|
|
|
|
try:
|
|
|
|
cluster.start()
|
2022-10-12 14:58:13 +00:00
|
|
|
yield
|
2022-10-11 15:28:20 +00:00
|
|
|
finally:
|
|
|
|
cluster.shutdown()
|
|
|
|
|
|
|
|
|
2022-10-12 14:58:13 +00:00
|
|
|
backup_id_counter = 0
|
|
|
|
|
|
|
|
|
|
|
|
def new_backup_name():
|
|
|
|
global backup_id_counter
|
|
|
|
backup_id_counter += 1
|
|
|
|
return f"backup{backup_id_counter}"
|
|
|
|
|
|
|
|
|
2023-06-28 08:52:00 +00:00
|
|
|
def get_events_for_query(query_id: str) -> Dict[str, int]:
|
|
|
|
events = TSV(
|
2023-05-16 19:42:56 +00:00
|
|
|
node.query(
|
2023-06-28 08:52:00 +00:00
|
|
|
f"""
|
|
|
|
SYSTEM FLUSH LOGS;
|
|
|
|
|
|
|
|
WITH arrayJoin(ProfileEvents) as pe
|
|
|
|
SELECT pe.1, pe.2
|
|
|
|
FROM system.query_log
|
|
|
|
WHERE query_id = '{query_id}'
|
|
|
|
"""
|
2023-05-16 19:42:56 +00:00
|
|
|
)
|
|
|
|
)
|
|
|
|
return {
|
|
|
|
event: int(value)
|
2023-06-28 08:52:00 +00:00
|
|
|
for event, value in [line.split("\t") for line in events.lines]
|
2023-05-16 19:42:56 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
|
2023-07-23 09:24:01 +00:00
|
|
|
def format_settings(settings):
|
|
|
|
if not settings:
|
|
|
|
return ""
|
|
|
|
return "SETTINGS " + ",".join(f"{k}={v}" for k, v in settings.items())
|
|
|
|
|
|
|
|
|
2023-05-16 19:42:56 +00:00
|
|
|
def check_backup_and_restore(
|
2023-06-28 08:52:00 +00:00
|
|
|
storage_policy,
|
|
|
|
backup_destination,
|
|
|
|
size=1000,
|
2023-07-23 09:24:01 +00:00
|
|
|
backup_settings=None,
|
|
|
|
restore_settings=None,
|
|
|
|
insert_settings=None,
|
|
|
|
optimize_table=True,
|
2023-05-16 19:42:56 +00:00
|
|
|
):
|
2023-07-23 09:24:01 +00:00
|
|
|
optimize_table_query = "OPTIMIZE TABLE data FINAL;" if optimize_table else ""
|
|
|
|
|
2022-10-12 14:58:13 +00:00
|
|
|
node.query(
|
|
|
|
f"""
|
2023-05-03 18:06:46 +00:00
|
|
|
DROP TABLE IF EXISTS data SYNC;
|
2022-10-12 14:58:13 +00:00
|
|
|
CREATE TABLE data (key Int, value String, array Array(String)) Engine=MergeTree() ORDER BY tuple() SETTINGS storage_policy='{storage_policy}';
|
2023-07-23 09:24:01 +00:00
|
|
|
INSERT INTO data SELECT * FROM generateRandom('key Int, value String, array Array(String)') LIMIT {size} {format_settings(insert_settings)};
|
|
|
|
{optimize_table_query}
|
2022-10-12 14:58:13 +00:00
|
|
|
"""
|
|
|
|
)
|
2023-07-23 09:24:01 +00:00
|
|
|
|
2023-05-16 19:42:56 +00:00
|
|
|
try:
|
2023-06-28 08:52:00 +00:00
|
|
|
backup_query_id = uuid.uuid4().hex
|
|
|
|
node.query(
|
2023-07-23 09:24:01 +00:00
|
|
|
f"BACKUP TABLE data TO {backup_destination} {format_settings(backup_settings)}",
|
|
|
|
query_id=backup_query_id,
|
2023-06-28 08:52:00 +00:00
|
|
|
)
|
|
|
|
restore_query_id = uuid.uuid4().hex
|
2023-05-16 19:42:56 +00:00
|
|
|
node.query(
|
|
|
|
f"""
|
2023-07-23 09:24:01 +00:00
|
|
|
RESTORE TABLE data AS data_restored FROM {backup_destination} {format_settings(restore_settings)};
|
2023-06-28 08:52:00 +00:00
|
|
|
""",
|
|
|
|
query_id=restore_query_id,
|
2023-05-16 19:42:56 +00:00
|
|
|
)
|
|
|
|
node.query(
|
|
|
|
"""
|
|
|
|
SELECT throwIf(
|
|
|
|
(SELECT count(), sum(sipHash64(*)) FROM data) !=
|
|
|
|
(SELECT count(), sum(sipHash64(*)) FROM data_restored),
|
|
|
|
'Data does not matched after BACKUP/RESTORE'
|
|
|
|
);
|
|
|
|
"""
|
|
|
|
)
|
2023-06-28 08:52:00 +00:00
|
|
|
return [
|
|
|
|
get_events_for_query(backup_query_id),
|
|
|
|
get_events_for_query(restore_query_id),
|
|
|
|
]
|
2023-05-16 19:42:56 +00:00
|
|
|
finally:
|
|
|
|
node.query(
|
|
|
|
"""
|
|
|
|
DROP TABLE data SYNC;
|
|
|
|
DROP TABLE IF EXISTS data_restored SYNC;
|
|
|
|
"""
|
|
|
|
)
|
2022-10-12 14:58:13 +00:00
|
|
|
|
|
|
|
|
2022-11-02 10:04:58 +00:00
|
|
|
def check_system_tables():
|
|
|
|
disks = [
|
|
|
|
tuple(disk.split("\t"))
|
|
|
|
for disk in node.query("SELECT name, type FROM system.disks").split("\n")
|
|
|
|
if disk
|
|
|
|
]
|
|
|
|
expected_disks = (
|
|
|
|
("default", "local"),
|
|
|
|
("disk_s3", "s3"),
|
2023-07-23 09:24:01 +00:00
|
|
|
("disk_s3_cache", "s3"),
|
2022-11-02 10:04:58 +00:00
|
|
|
("disk_s3_other_bucket", "s3"),
|
|
|
|
("disk_s3_plain", "s3_plain"),
|
|
|
|
)
|
|
|
|
assert len(expected_disks) == len(disks)
|
|
|
|
for expected_disk in expected_disks:
|
|
|
|
if expected_disk not in disks:
|
|
|
|
raise AssertionError(f"Missed {expected_disk} in {disks}")
|
|
|
|
|
|
|
|
|
2022-10-11 15:28:20 +00:00
|
|
|
@pytest.mark.parametrize(
|
2022-10-12 14:58:13 +00:00
|
|
|
"storage_policy, to_disk",
|
2022-10-11 15:28:20 +00:00
|
|
|
[
|
|
|
|
pytest.param(
|
|
|
|
"default",
|
|
|
|
"default",
|
|
|
|
id="from_local_to_local",
|
|
|
|
),
|
|
|
|
pytest.param(
|
2022-10-12 14:58:13 +00:00
|
|
|
"policy_s3",
|
2022-10-11 15:28:20 +00:00
|
|
|
"default",
|
|
|
|
id="from_s3_to_local",
|
|
|
|
),
|
|
|
|
pytest.param(
|
|
|
|
"default",
|
2022-10-12 14:58:13 +00:00
|
|
|
"disk_s3",
|
2022-10-11 15:28:20 +00:00
|
|
|
id="from_local_to_s3",
|
|
|
|
),
|
|
|
|
pytest.param(
|
2022-10-12 14:58:13 +00:00
|
|
|
"policy_s3",
|
|
|
|
"disk_s3_plain",
|
2022-10-11 15:28:20 +00:00
|
|
|
id="from_s3_to_s3_plain",
|
|
|
|
),
|
|
|
|
pytest.param(
|
|
|
|
"default",
|
2022-10-12 14:58:13 +00:00
|
|
|
"disk_s3_plain",
|
2022-10-11 15:28:20 +00:00
|
|
|
id="from_local_to_s3_plain",
|
|
|
|
),
|
|
|
|
],
|
|
|
|
)
|
2022-10-12 14:58:13 +00:00
|
|
|
def test_backup_to_disk(storage_policy, to_disk):
|
|
|
|
backup_name = new_backup_name()
|
|
|
|
backup_destination = f"Disk('{to_disk}', '{backup_name}')"
|
|
|
|
check_backup_and_restore(storage_policy, backup_destination)
|
|
|
|
|
|
|
|
|
|
|
|
def test_backup_to_s3():
|
|
|
|
storage_policy = "default"
|
|
|
|
backup_name = new_backup_name()
|
|
|
|
backup_destination = (
|
|
|
|
f"S3('http://minio1:9001/root/data/backups/{backup_name}', 'minio', 'minio123')"
|
|
|
|
)
|
|
|
|
check_backup_and_restore(storage_policy, backup_destination)
|
2022-11-02 10:04:58 +00:00
|
|
|
check_system_tables()
|
2022-10-12 14:58:13 +00:00
|
|
|
|
|
|
|
|
|
|
|
def test_backup_to_s3_named_collection():
|
|
|
|
storage_policy = "default"
|
|
|
|
backup_name = new_backup_name()
|
|
|
|
backup_destination = f"S3(named_collection_s3_backups, '{backup_name}')"
|
|
|
|
check_backup_and_restore(storage_policy, backup_destination)
|
|
|
|
|
|
|
|
|
2023-01-10 00:32:37 +00:00
|
|
|
def test_backup_to_s3_multipart():
|
|
|
|
storage_policy = "default"
|
|
|
|
backup_name = new_backup_name()
|
|
|
|
backup_destination = f"S3('http://minio1:9001/root/data/backups/multipart/{backup_name}', 'minio', 'minio123')"
|
2023-06-28 08:52:00 +00:00
|
|
|
(backup_events, restore_events) = check_backup_and_restore(
|
2023-05-16 19:42:56 +00:00
|
|
|
storage_policy,
|
|
|
|
backup_destination,
|
|
|
|
size=1000000,
|
|
|
|
)
|
2023-01-10 00:32:37 +00:00
|
|
|
assert node.contains_in_log(
|
2023-01-21 14:34:09 +00:00
|
|
|
f"copyDataToS3File: Multipart upload has completed. Bucket: root, Key: data/backups/multipart/{backup_name}"
|
2023-01-10 00:32:37 +00:00
|
|
|
)
|
|
|
|
|
2023-06-28 08:52:00 +00:00
|
|
|
s3_backup_events = (
|
|
|
|
"WriteBufferFromS3Microseconds",
|
|
|
|
"WriteBufferFromS3Bytes",
|
|
|
|
"WriteBufferFromS3RequestsErrors",
|
|
|
|
)
|
|
|
|
s3_restore_events = (
|
|
|
|
"ReadBufferFromS3Microseconds",
|
|
|
|
"ReadBufferFromS3Bytes",
|
|
|
|
"ReadBufferFromS3RequestsErrors",
|
|
|
|
)
|
|
|
|
|
|
|
|
objects = node.cluster.minio_client.list_objects(
|
|
|
|
"root", f"data/backups/multipart/{backup_name}/"
|
|
|
|
)
|
|
|
|
backup_meta_size = 0
|
|
|
|
for obj in objects:
|
|
|
|
if ".backup" in obj.object_name:
|
|
|
|
backup_meta_size = obj.size
|
|
|
|
break
|
|
|
|
backup_total_size = int(
|
|
|
|
node.query(
|
|
|
|
f"SELECT sum(total_size) FROM system.backups WHERE status = 'BACKUP_CREATED' AND name like '%{backup_name}%'"
|
|
|
|
).strip()
|
|
|
|
)
|
|
|
|
restore_total_size = int(
|
|
|
|
node.query(
|
|
|
|
f"SELECT sum(total_size) FROM system.backups WHERE status = 'RESTORED' AND name like '%{backup_name}%'"
|
|
|
|
).strip()
|
|
|
|
)
|
|
|
|
# backup
|
|
|
|
# NOTE: ~35 bytes is used by .lock file, so set up 100 bytes to avoid flaky test
|
|
|
|
assert (
|
|
|
|
abs(
|
|
|
|
backup_total_size
|
|
|
|
- (backup_events["WriteBufferFromS3Bytes"] - backup_meta_size)
|
|
|
|
)
|
|
|
|
< 100
|
|
|
|
)
|
|
|
|
assert backup_events["WriteBufferFromS3Microseconds"] > 0
|
|
|
|
assert "WriteBufferFromS3RequestsErrors" not in backup_events
|
|
|
|
# restore
|
|
|
|
assert (
|
|
|
|
restore_events["ReadBufferFromS3Bytes"] - backup_meta_size == restore_total_size
|
|
|
|
)
|
|
|
|
assert restore_events["ReadBufferFromS3Microseconds"] > 0
|
|
|
|
assert "ReadBufferFromS3RequestsErrors" not in restore_events
|
|
|
|
|
2023-01-10 00:32:37 +00:00
|
|
|
|
2022-10-12 14:58:13 +00:00
|
|
|
def test_backup_to_s3_native_copy():
|
|
|
|
storage_policy = "policy_s3"
|
|
|
|
backup_name = new_backup_name()
|
|
|
|
backup_destination = (
|
|
|
|
f"S3('http://minio1:9001/root/data/backups/{backup_name}', 'minio', 'minio123')"
|
|
|
|
)
|
2023-06-28 08:58:23 +00:00
|
|
|
(backup_events, restore_events) = check_backup_and_restore(
|
|
|
|
storage_policy, backup_destination
|
|
|
|
)
|
|
|
|
# single part upload
|
|
|
|
assert backup_events["S3CopyObject"] > 0
|
|
|
|
assert restore_events["S3CopyObject"] > 0
|
2023-01-10 00:32:37 +00:00
|
|
|
assert node.contains_in_log(
|
2023-01-21 14:34:09 +00:00
|
|
|
f"copyS3File: Single operation copy has completed. Bucket: root, Key: data/backups/{backup_name}"
|
2023-01-10 00:32:37 +00:00
|
|
|
)
|
2022-10-12 14:58:13 +00:00
|
|
|
|
|
|
|
|
2022-10-31 23:01:27 +00:00
|
|
|
def test_backup_to_s3_native_copy_other_bucket():
|
2022-10-12 14:58:13 +00:00
|
|
|
storage_policy = "policy_s3_other_bucket"
|
|
|
|
backup_name = new_backup_name()
|
|
|
|
backup_destination = (
|
|
|
|
f"S3('http://minio1:9001/root/data/backups/{backup_name}', 'minio', 'minio123')"
|
2022-10-11 15:28:20 +00:00
|
|
|
)
|
2023-06-28 08:58:23 +00:00
|
|
|
(backup_events, restore_events) = check_backup_and_restore(
|
|
|
|
storage_policy, backup_destination
|
|
|
|
)
|
|
|
|
# single part upload
|
|
|
|
assert backup_events["S3CopyObject"] > 0
|
|
|
|
assert restore_events["S3CopyObject"] > 0
|
2023-01-10 00:32:37 +00:00
|
|
|
assert node.contains_in_log(
|
2023-01-21 14:34:09 +00:00
|
|
|
f"copyS3File: Single operation copy has completed. Bucket: root, Key: data/backups/{backup_name}"
|
2023-01-10 00:32:37 +00:00
|
|
|
)
|
2022-10-31 23:01:27 +00:00
|
|
|
|
|
|
|
|
2023-01-10 00:32:37 +00:00
|
|
|
def test_backup_to_s3_native_copy_multipart():
|
2022-10-31 23:01:27 +00:00
|
|
|
storage_policy = "policy_s3"
|
|
|
|
backup_name = new_backup_name()
|
2023-01-10 00:32:37 +00:00
|
|
|
backup_destination = f"S3('http://minio1:9001/root/data/backups/multipart/{backup_name}', 'minio', 'minio123')"
|
2023-06-28 08:58:23 +00:00
|
|
|
(backup_events, restore_events) = check_backup_and_restore(
|
|
|
|
storage_policy, backup_destination, size=1000000
|
|
|
|
)
|
|
|
|
# multi part upload
|
|
|
|
assert backup_events["S3CreateMultipartUpload"] > 0
|
|
|
|
assert restore_events["S3CreateMultipartUpload"] > 0
|
2023-01-10 00:32:37 +00:00
|
|
|
assert node.contains_in_log(
|
2023-01-21 14:34:09 +00:00
|
|
|
f"copyS3File: Multipart upload has completed. Bucket: root, Key: data/backups/multipart/{backup_name}/"
|
2023-01-10 00:32:37 +00:00
|
|
|
)
|
2023-05-10 09:52:09 +00:00
|
|
|
|
|
|
|
|
|
|
|
def test_incremental_backup_append_table_def():
|
|
|
|
backup_name = f"S3('http://minio1:9001/root/data/backups/{new_backup_name()}', 'minio', 'minio123')"
|
|
|
|
|
|
|
|
node.query(
|
|
|
|
"CREATE TABLE data (x UInt32, y String) Engine=MergeTree() ORDER BY y PARTITION BY x%10 SETTINGS storage_policy='policy_s3'"
|
|
|
|
)
|
|
|
|
|
|
|
|
node.query("INSERT INTO data SELECT number, toString(number) FROM numbers(100)")
|
|
|
|
assert node.query("SELECT count(), sum(x) FROM data") == "100\t4950\n"
|
|
|
|
|
|
|
|
node.query(f"BACKUP TABLE data TO {backup_name}")
|
|
|
|
|
|
|
|
node.query("ALTER TABLE data MODIFY SETTING parts_to_throw_insert=100")
|
|
|
|
|
|
|
|
incremental_backup_name = f"S3('http://minio1:9001/root/data/backups/{new_backup_name()}', 'minio', 'minio123')"
|
|
|
|
|
|
|
|
node.query(
|
|
|
|
f"BACKUP TABLE data TO {incremental_backup_name} SETTINGS base_backup = {backup_name}"
|
|
|
|
)
|
|
|
|
|
|
|
|
node.query("DROP TABLE data")
|
|
|
|
node.query(f"RESTORE TABLE data FROM {incremental_backup_name}")
|
|
|
|
|
|
|
|
assert node.query("SELECT count(), sum(x) FROM data") == "100\t4950\n"
|
|
|
|
assert "parts_to_throw_insert = 100" in node.query("SHOW CREATE TABLE data")
|
2023-07-23 09:24:01 +00:00
|
|
|
|
|
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
|
|
"in_cache_initially, allow_backup_read_cache, allow_s3_native_copy",
|
|
|
|
[
|
|
|
|
(False, True, False),
|
|
|
|
(True, False, False),
|
|
|
|
(True, True, False),
|
|
|
|
(True, True, True),
|
|
|
|
],
|
|
|
|
)
|
|
|
|
def test_backup_with_fs_cache(
|
|
|
|
in_cache_initially, allow_backup_read_cache, allow_s3_native_copy
|
|
|
|
):
|
|
|
|
storage_policy = "policy_s3_cache"
|
|
|
|
|
|
|
|
backup_name = new_backup_name()
|
|
|
|
backup_destination = (
|
|
|
|
f"S3('http://minio1:9001/root/data/backups/{backup_name}', 'minio', 'minio123')"
|
|
|
|
)
|
|
|
|
|
|
|
|
insert_settings = {
|
|
|
|
"enable_filesystem_cache_on_write_operations": int(in_cache_initially)
|
|
|
|
}
|
|
|
|
|
|
|
|
backup_settings = {
|
2023-07-23 11:00:17 +00:00
|
|
|
"read_from_filesystem_cache": int(allow_backup_read_cache),
|
2023-07-23 09:24:01 +00:00
|
|
|
"allow_s3_native_copy": int(allow_s3_native_copy),
|
|
|
|
}
|
|
|
|
|
|
|
|
restore_settings = {"allow_s3_native_copy": int(allow_s3_native_copy)}
|
|
|
|
|
|
|
|
backup_events, restore_events = check_backup_and_restore(
|
|
|
|
storage_policy,
|
|
|
|
backup_destination,
|
|
|
|
size=10,
|
|
|
|
insert_settings=insert_settings,
|
|
|
|
optimize_table=False,
|
|
|
|
backup_settings=backup_settings,
|
|
|
|
restore_settings=restore_settings,
|
|
|
|
)
|
|
|
|
|
2023-07-23 11:00:17 +00:00
|
|
|
# print(f"backup_events = {backup_events}")
|
|
|
|
# print(f"restore_events = {restore_events}")
|
2023-07-23 09:24:01 +00:00
|
|
|
|
|
|
|
# BACKUP never updates the filesystem cache but it may read it if `read_from_filesystem_cache_if_exists_otherwise_bypass_cache` allows that.
|
|
|
|
if allow_backup_read_cache and in_cache_initially:
|
|
|
|
assert backup_events["CachedReadBufferReadFromCacheBytes"] > 0
|
|
|
|
assert not "CachedReadBufferReadFromSourceBytes" in backup_events
|
|
|
|
elif allow_backup_read_cache:
|
|
|
|
assert not "CachedReadBufferReadFromCacheBytes" in backup_events
|
|
|
|
assert backup_events["CachedReadBufferReadFromSourceBytes"] > 0
|
|
|
|
else:
|
|
|
|
assert not "CachedReadBufferReadFromCacheBytes" in backup_events
|
|
|
|
assert not "CachedReadBufferReadFromSourceBytes" in backup_events
|
|
|
|
|
|
|
|
assert not "CachedReadBufferCacheWriteBytes" in backup_events
|
|
|
|
assert not "CachedWriteBufferCacheWriteBytes" in backup_events
|
|
|
|
|
|
|
|
# RESTORE doesn't use the filesystem cache during write operations.
|
|
|
|
# However while attaching parts it may use the cache while reading such files as "columns.txt" or "checksums.txt" or "primary.idx",
|
|
|
|
# see IMergeTreeDataPart::loadColumnsChecksumsIndexes()
|
|
|
|
if "CachedReadBufferReadFromSourceBytes" in restore_events:
|
|
|
|
assert (
|
|
|
|
restore_events["CachedReadBufferReadFromSourceBytes"]
|
|
|
|
== restore_events["CachedReadBufferCacheWriteBytes"]
|
|
|
|
)
|
|
|
|
|
|
|
|
assert not "CachedReadBufferReadFromCacheBytes" in restore_events
|
|
|
|
|
|
|
|
# "format_version.txt" is written when a table is created,
|
|
|
|
# see MergeTreeData::initializeDirectoriesAndFormatVersion()
|
|
|
|
if "CachedWriteBufferCacheWriteBytes" in restore_events:
|
|
|
|
assert restore_events["CachedWriteBufferCacheWriteBytes"] <= 1
|