| # |
| # |
| # Licensed to the Apache Software Foundation (ASF) under one |
| # or more contributor license agreements. See the NOTICE file |
| # distributed with this work for additional information |
| # regarding copyright ownership. The ASF licenses this file |
| # to you under the Apache License, Version 2.0 (the |
| # "License"); you may not use this file except in compliance |
| # with the License. You may obtain a copy of the License at |
| # |
| # http://www.apache.org/licenses/LICENSE-2.0 |
| # |
| # Unless required by applicable law or agreed to in writing, software |
| # distributed under the License is distributed on an "AS IS" BASIS, |
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| # See the License for the specific language governing permissions and |
| # limitations under the License. |
| # |
| |
| module Shell |
| module Commands |
| class Create < Command |
| def help |
| return <<-EOF |
| Creates a table. Pass a table name, and a set of column family |
| specifications (at least one), and, optionally, table configuration. |
| Column specification can be a simple string (name), or a dictionary |
| (dictionaries are described below in main help output), necessarily |
| including NAME attribute. |
| Examples: |
| |
| Create a table with namespace=ns1 and table qualifier=t1 |
| hbase> create 'ns1:t1', {NAME => 'f1', VERSIONS => 5} |
| |
| Create a table with namespace=default and table qualifier=t1 |
| hbase> create 't1', {NAME => 'f1'}, {NAME => 'f2'}, {NAME => 'f3'} |
| hbase> # The above in shorthand would be the following: |
| hbase> create 't1', 'f1', 'f2', 'f3' |
| hbase> create 't1', {NAME => 'f1', VERSIONS => 1, TTL => 2592000, BLOCKCACHE => true} |
| hbase> create 't1', {NAME => 'f1', CONFIGURATION => {'hbase.hstore.blockingStoreFiles' => '10'}} |
| |
| Table configuration options can be put at the end. |
| Examples: |
| |
| hbase> create 'ns1:t1', 'f1', SPLITS => ['10', '20', '30', '40'] |
| hbase> create 't1', 'f1', SPLITS => ['10', '20', '30', '40'] |
| hbase> create 't1', 'f1', SPLITS_FILE => 'splits.txt', OWNER => 'johndoe' |
| hbase> create 't1', {NAME => 'f1', VERSIONS => 5}, METADATA => { 'mykey' => 'myvalue' } |
| hbase> # Optionally pre-split the table into NUMREGIONS, using |
| hbase> # SPLITALGO ("HexStringSplit", "UniformSplit" or classname) |
| hbase> create 't1', 'f1', {NUMREGIONS => 15, SPLITALGO => 'HexStringSplit'} |
| hbase> create 't1', 'f1', {NUMREGIONS => 15, SPLITALGO => 'HexStringSplit', REGION_REPLICATION => 2, CONFIGURATION => {'hbase.hregion.scan.loadColumnFamiliesOnDemand' => 'true'}} |
| |
| You can also keep around a reference to the created table: |
| |
| hbase> t1 = create 't1', 'f1' |
| |
| Which gives you a reference to the table named 't1', on which you can then |
| call methods. |
| EOF |
| end |
| |
| def command(table, *args) |
| format_simple_command do |
| ret = admin.create(table, *args) |
| end |
| #and then return the table you just created |
| table(table) |
| end |
| end |
| end |
| end |