001/* 002 * Licensed to the Apache Software Foundation (ASF) under one 003 * or more contributor license agreements. See the NOTICE file 004 * distributed with this work for additional information 005 * regarding copyright ownership. The ASF licenses this file 006 * to you under the Apache License, Version 2.0 (the 007 * "License"); you may not use this file except in compliance 008 * with the License. You may obtain a copy of the License at 009 * 010 * http://www.apache.org/licenses/LICENSE-2.0 011 * 012 * Unless required by applicable law or agreed to in writing, software 013 * distributed under the License is distributed on an "AS IS" BASIS, 014 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 015 * See the License for the specific language governing permissions and 016 * limitations under the License. 017 */ 018package org.apache.hadoop.hbase.io.hfile; 019 020import static org.junit.Assert.assertEquals; 021import static org.junit.Assert.assertNotEquals; 022import static org.junit.Assert.assertTrue; 023 024import com.codahale.metrics.MetricRegistry; 025import java.io.ByteArrayOutputStream; 026import java.io.PrintStream; 027import org.apache.hadoop.conf.Configuration; 028import org.apache.hadoop.fs.FileSystem; 029import org.apache.hadoop.fs.Path; 030import org.apache.hadoop.hbase.HBaseClassTestRule; 031import org.apache.hadoop.hbase.HBaseTestingUtil; 032import org.apache.hadoop.hbase.regionserver.TestHRegionServerBulkLoad; 033import org.apache.hadoop.hbase.testclassification.IOTests; 034import org.apache.hadoop.hbase.testclassification.SmallTests; 035import org.apache.hadoop.hbase.util.Bytes; 036import org.apache.hadoop.hbase.util.CommonFSUtils; 037import org.junit.After; 038import org.junit.Before; 039import org.junit.ClassRule; 040import org.junit.Test; 041import org.junit.experimental.categories.Category; 042import org.slf4j.Logger; 043import org.slf4j.LoggerFactory; 044 045@Category({ IOTests.class, SmallTests.class }) 046public class TestHFilePrettyPrinter { 047 048 @ClassRule 049 public static final HBaseClassTestRule CLASS_RULE = 050 HBaseClassTestRule.forClass(TestHFilePrettyPrinter.class); 051 052 private static final Logger LOG = LoggerFactory.getLogger(TestHFilePrettyPrinter.class); 053 054 private final static HBaseTestingUtil UTIL = new HBaseTestingUtil(); 055 private static FileSystem fs; 056 private static Configuration conf; 057 private static byte[] cf = Bytes.toBytes("cf"); 058 private static byte[] fam = Bytes.toBytes("fam"); 059 private static byte[] value = Bytes.toBytes("val"); 060 private static PrintStream original; 061 private static PrintStream ps; 062 private static ByteArrayOutputStream stream; 063 064 @Before 065 public void setup() throws Exception { 066 conf = UTIL.getConfiguration(); 067 // Runs on local filesystem. Test does not need sync. Turn off checks. 068 conf.setBoolean(CommonFSUtils.UNSAFE_STREAM_CAPABILITY_ENFORCE, false); 069 fs = UTIL.getTestFileSystem(); 070 stream = new ByteArrayOutputStream(); 071 ps = new PrintStream(stream); 072 } 073 074 @After 075 public void teardown() { 076 original = System.out; 077 System.setOut(original); 078 } 079 080 @Test 081 public void testHFilePrettyPrinterNonRootDir() throws Exception { 082 Path fileNotInRootDir = UTIL.getDataTestDir("hfile"); 083 TestHRegionServerBulkLoad.createHFile(fs, fileNotInRootDir, cf, fam, value, 1000); 084 assertNotEquals("directory used is not an HBase root dir", UTIL.getDefaultRootDirPath(), 085 fileNotInRootDir); 086 087 System.setOut(ps); 088 new HFilePrettyPrinter(conf).run(new String[] { "-v", String.valueOf(fileNotInRootDir) }); 089 String result = new String(stream.toByteArray()); 090 String expectedResult = "Scanning -> " + fileNotInRootDir + "\n" + "Scanned kv count -> 1000\n"; 091 assertEquals(expectedResult, result); 092 } 093 094 @Test 095 public void testHFilePrettyPrinterRootDir() throws Exception { 096 Path rootPath = CommonFSUtils.getRootDir(conf); 097 String rootString = rootPath + rootPath.SEPARATOR; 098 Path fileInRootDir = new Path(rootString + "hfile"); 099 TestHRegionServerBulkLoad.createHFile(fs, fileInRootDir, cf, fam, value, 1000); 100 assertTrue("directory used is a root dir", fileInRootDir.toString().startsWith(rootString)); 101 102 System.setOut(ps); 103 HFilePrettyPrinter printer = new HFilePrettyPrinter(); 104 printer.setConf(conf); 105 printer.processFile(fileInRootDir, true); 106 printer.run(new String[] { "-v", String.valueOf(fileInRootDir) }); 107 String result = new String(stream.toByteArray()); 108 String expectedResult = "Scanning -> " + fileInRootDir + "\n" + "Scanned kv count -> 1000\n"; 109 assertEquals(expectedResult, result); 110 } 111 112 @Test 113 public void testHFilePrettyPrinterSeekFirstRow() throws Exception { 114 Path fileNotInRootDir = UTIL.getDataTestDir("hfile"); 115 TestHRegionServerBulkLoad.createHFile(fs, fileNotInRootDir, cf, fam, value, 1000); 116 assertNotEquals("directory used is not an HBase root dir", UTIL.getDefaultRootDirPath(), 117 fileNotInRootDir); 118 119 HFile.Reader reader = 120 HFile.createReader(fs, fileNotInRootDir, CacheConfig.DISABLED, true, conf); 121 String firstRowKey = new String(reader.getFirstRowKey().get()); 122 123 System.setOut(ps); 124 new HFilePrettyPrinter(conf) 125 .run(new String[] { "-v", "-w" + firstRowKey, String.valueOf(fileNotInRootDir) }); 126 String result = new String(stream.toByteArray()); 127 String expectedResult = "Scanning -> " + fileNotInRootDir + "\n" + "Scanned kv count -> 1\n"; 128 assertEquals(expectedResult, result); 129 } 130 131 @Test 132 public void testHistograms() throws Exception { 133 Path fileNotInRootDir = UTIL.getDataTestDir("hfile"); 134 TestHRegionServerBulkLoad.createHFile(fs, fileNotInRootDir, cf, fam, value, 1000); 135 assertNotEquals("directory used is not an HBase root dir", UTIL.getDefaultRootDirPath(), 136 fileNotInRootDir); 137 138 System.setOut(ps); 139 new HFilePrettyPrinter(conf).run(new String[] { "-s", "-d", String.valueOf(fileNotInRootDir) }); 140 String result = stream.toString(); 141 LOG.info(result); 142 143 // split out the output into sections based on the headers 144 String[] headers = 145 new String[] { "Key length", "Val length", "Row size (bytes)", "Row size (columns)" }; 146 // for each section, there is a corresponding expected (count, range) pairs 147 int[][] expectations = new int[][] { new int[] { 0, 10, 1000, 50 }, new int[] { 0, 1, 1000, 3 }, 148 new int[] { 0, 10, 1000, 50 }, new int[] { 1000, 1 }, }; 149 150 for (int i = 0; i < headers.length - 1; i++) { 151 int idx = result.indexOf(headers[i]); 152 int nextIdx = result.indexOf(headers[i + 1]); 153 154 assertContainsRanges(result.substring(idx, nextIdx), expectations[i]); 155 } 156 } 157 158 private void assertContainsRanges(String result, int... rangeCountPairs) { 159 for (int i = 0; i < rangeCountPairs.length - 1; i += 2) { 160 String expected = rangeCountPairs[i + 1] + " <= " + rangeCountPairs[i]; 161 assertTrue("expected:\n" + result + "\nto contain: '" + expected + "'", 162 result.contains(expected)); 163 } 164 } 165 166 @Test 167 public void testKeyValueStats() { 168 HFilePrettyPrinter.KeyValueStats stats = 169 new HFilePrettyPrinter.KeyValueStats(new MetricRegistry(), "test"); 170 long[] ranges = stats.getRanges(); 171 for (long range : ranges) { 172 stats.update(range - 1, true); 173 } 174 175 assertEquals(ranges[ranges.length - 1] - 1, stats.getMax()); 176 assertEquals(ranges[0] - 1, stats.getMin()); 177 178 int total = 1; 179 for (long range : ranges) { 180 long val = stats.getCountAtOrBelow(range); 181 assertEquals(total++, val); 182 } 183 184 } 185}