table create
Creates a new MapR-DB binary or JSON table.
Syntax
CLI |
|
REST |
|
Parameters
Parameter |
Description |
---|---|
path |
The path to the new MapR-DB table.
|
copymetafrom |
The path to a table that contains the metadata that should be used to create the table.
|
copymetatype |
The type of metadata to copy from the table identified in the
|
regionsizemb |
The average size of the regions into which MapR-DB tries to split the table as
the table grows. The default is 4096 MB. This value is ignored if
If Although splits are automatic, merges are not. For example, if the value of
NOTE: When a table has less than 4 regions, MapR-DB ignores the
regionsizemb parameter and splits regions at a lower threshold.
|
autosplit |
A Boolean value that specifies whether to split the table into regions
automatically as the table grows. The average size of each region is determined by
the The default value is |
bulkload |
A Boolean value that specifies whether to allow a full bulk
load of the table. The default is |
audit | Specifies whether to turn auditing on for the table. If auditing is also
enabled at the cluster level with the maprcli audit data command
and enabled for the current volume, setting this value to true causes auditing to
start for the table. |
tabletype | Specifies whether the table will be a binary table or
a JSON table. The values are binary and json .
The default is binary . |
insertionorder |
Applies to JSON tables only: Specifies whether query results are to list fields in the order in which fields were inserted into column families. Column families are always returned in alphabetical order according to their names. For example, suppose you had a JSON table that contained documents with this
general structure:
Both
trailers and images are separate column families named, say, cf1
and cf2 respectively (while title belongs to default column
family). An application retrieves the full document for each
movie. If
-insertionorder is set to true , the
results are returned in this order:
The
results are identical to the original document, except that the fields are
arranged by column family names (cf1 , cf2 , and
default) in alphabetical order, as they always are for a query. If
-insertionorder is set to
false , the results are returned in this order:
The
results are similar to the previous results. This time, however, all the fields
are in alphabetical order. |
packperm | The Access Control Expression that controls who can pack table regions. By default, permission is given to the user ID that is used to create the table. |
bulkloadperm | The Access Control Expression that controls who can load this table with bulk loads if the table was created with bulk load support. By default, permission is given to the user ID that is used to create the table. |
splitmergeperm |
The Access Control Expression that controls who can take the following actions:
By default, permission is given to the user ID that is used to create the table. |
createrenamefamilyperm | The Access Control Expression that controls who can create column families for this table or rename existing column families. By default, permission is given to the user ID that is used to create the table. |
deletefamilyperm | The Access Control Expression that defines access to delete column families for this table. Delimit the expression with single-quotation marks. By default, permission is given to the user ID that is used to create the table. |
adminaccessperm | The Access Control Expression that controls who can view and edit the permissions for this table. By default, permission is given to the user ID that is used to create the table. |
replperm | The Access Control Expression that controls who can set up replication either to or from a table. By default, permission is given to the user ID that is used to create the table |
defaultversionperm |
The default Access Control Expression for the version permission on new column
families that are created in this table. If no value is specified, the default is
u:<username of the table creator> . This value of the
parameter versionperm in the table cf create and
table cf edit commands overrides this value.NOTE: This permission is not applicable to JSON tables. Versioning is not supported for JSON
documents. |
defaultcompressionperm | Applies to binary tables only:
The default Access Control Expression for the compression permission on new column
families that are created in this table. If no value is specified, the default is
u:<username of the table creator> . This value of the
parameter compressionperm in the table cf create
and table cf edit commands overrides this value. |
defaultmemoryperm |
The default Access Control Expression for the memory permission on new column
families that are created in this table. If no value is specified, the default is
|
defaultreadperm | The default Access Control Expression for the read permission on new column
families that are created in this table. If no value is specified, the default is
u:<username of the table creator> . This value of the
parameter readperm in the table cf create and
table cf edit commands overrides this value.For more information about this permission as it applies to JSON tables, see Granting or Denying Access to Fields with Access-Control Expressions. |
defaultwriteperm | The default Access Control Expression for the write permission on new column
families that are created in this table. If no value is specified, the default is
u:<username of the table creator> . This value of the
parameter writeperm in the table cf create and
table cf edit commands overrides this value.For more information about this permission as it applies to JSON tables, see Granting or Denying Access to Fields with Access-Control Expressions. |
defaulttraverseperm | Applies to JSON tables only: The default Access Control Expression for the traverse permission on new column families. For more information about this permission, see Granting or Denying Access to Fields with Access-Control Expressions. |
defaultappendperm | Applies to binary tables only:
The default Access Control Expression for the append permission on new column
families that are created in this table. If no value is specified, the default is
u:<username of the table creator> . This value of the
parameter appendperm in the table cf create and
table cf edit commands overrides this value. |
Examples
Creates a new MapR table namednewtable
in
volume1
:
CLI |
|
REST |
|