-
Notifications
You must be signed in to change notification settings - Fork 5.5k
/
shard_collection.idl
115 lines (111 loc) · 4.57 KB
/
shard_collection.idl
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
# Copyright (C) 2021-present MongoDB, Inc.
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the Server Side Public License, version 1,
# as published by MongoDB, Inc.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# Server Side Public License for more details.
#
# You should have received a copy of the Server Side Public License
# along with this program. If not, see
# <http://www.mongodb.com/licensing/server-side-public-license>.
#
# As a special exception, the copyright holders give permission to link the
# code of portions of this program with the OpenSSL library under certain
# conditions as described in each individual source file and distribute
# linked combinations including the program with the OpenSSL library. You
# must comply with the Server Side Public License in all respects for
# all of the code used other than as permitted herein. If you modify file(s)
# with this exception, you may extend this exception to your version of the
# file(s), but you are not obligated to do so. If you do not wish to do so,
# delete this exception statement from your version. If you delete this
# exception statement from all source files in the program, then also delete
# it in the license file.
#
global:
cpp_namespace: "mongo"
imports:
- "mongo/db/basic_types.idl"
- "mongo/db/timeseries/timeseries.idl"
- "mongo/s/sharding_types.idl"
structs:
ShardCollection:
description: "The public shardCollection command."
strict: false
fields:
shardCollection:
type: namespacestring
description: "The namespace of the collection to shard in the form <database>.<collection>."
optional: true
shardcollection:
type: namespacestring
description: >-
Same as the previous field, but refers to the deprecated version of this command's name.
optional: true
key:
type: object
description: "The index specification document to use as the shard key."
unique:
type: bool
description: "Whether the shard key index should enforce a unique constraint"
default: false
numInitialChunks:
type: safeInt64
description: >-
The number of chunks to create initially when sharding an empty collection with a hashed
shard key.
default: 0
presplitHashedZones:
type: bool
description: >-
True if the chunks should be pre-split based on the existing zones when sharding a
collection with hashed shard key.
default: false
collation:
type: object
description: "The collation to use for the shard key index."
optional: true
timeseries:
description: "The options to create the time-series collection with."
type: TimeseriesOptions
optional: true
collectionUUID:
description: "The expected UUID of the collection."
type: uuid
optional: true
implicitlyCreateIndex:
description: "Creates an index on the shard key pattern if the collection is empty."
type: optionalBool
enforceUniquenessCheck:
description: >-
Controls whether this command verifies that any unique indexes are prefixed by the shard
key pattern if unique is true. If true then it will verify and if false then it won't.
type: optionalBool
commands:
# Temporary command to run shardCollection with unsplittable=true and track unsharded
# collection.
# TODO SERVER-79158: Remove this test command once createCollection can create unsplittable
# collections.
createUnsplittableCollection:
command_name: createUnsplittableCollection
cpp_name: CreateUnsplittableCollection
description: "The test only and temporary createUnsplittableCollection command for mongos."
strict: false
namespace: concatenate_with_db
api_version: ""
fields:
timeseries:
description: "The options to create the time-series collection with."
type: TimeseriesOptions
optional: true
collectionUUID:
description: "The expected UUID of the collection."
type: uuid
optional: true
dataShard:
description: "If set, the data for the collection will reside on the specified shard."
type: shard_id
optional: true