n3nash commented on a change in pull request #600: Timeline Service with Incremental View Syncing support URL: https://github.com/apache/incubator-hudi/pull/600#discussion_r274219635
########## File path: hoodie-common/src/main/java/com/uber/hoodie/common/table/view/FileSystemViewManager.java ########## @@ -0,0 +1,197 @@ +/* + * Copyright (c) 2018 Uber Technologies, Inc. (hoodie-dev-gr...@uber.com) + * + * Licensed 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. + */ + +package com.uber.hoodie.common.table.view; + +import com.uber.hoodie.common.SerializableConfiguration; +import com.uber.hoodie.common.table.HoodieTableMetaClient; +import com.uber.hoodie.common.table.HoodieTimeline; +import com.uber.hoodie.common.table.HoodieView; +import com.uber.hoodie.common.util.Functions.Function2; +import java.util.concurrent.ConcurrentHashMap; +import org.apache.log4j.LogManager; +import org.apache.log4j.Logger; + +/** + * A container that can potentially hold one or more dataset's + * file-system views. There is one view for each dataset. This is a view built against a timeline containing completed + * actions. In an embedded timeline-server mode, this typically holds only one dataset's view. + * In a stand-alone server mode, this can hold more than one dataset's views. + */ +public class FileSystemViewManager { + private static Logger logger = LogManager.getLogger(FileSystemViewManager.class); + + private final SerializableConfiguration conf; + // The View Storage config used to store file-system views + private final FileSystemViewStorageConfig viewConfig; + // Map from Base-Path to View + private final ConcurrentHashMap<String, HoodieView> globalViewMap; + // Factory Map to create file-system views + private final Function2<String, FileSystemViewStorageConfig, HoodieView> viewCreator; + + public FileSystemViewManager(SerializableConfiguration conf, FileSystemViewStorageConfig viewConfig, + Function2<String, FileSystemViewStorageConfig, HoodieView> viewCreator) { + this.conf = conf; + this.viewConfig = viewConfig; + this.globalViewMap = new ConcurrentHashMap<>(); + this.viewCreator = viewCreator; + } + + /** + * Drops reference to File-System Views. Future calls to view results in creating a new view + * @param basePath + */ + public void clearFileSystemView(String basePath) { + HoodieView view = globalViewMap.remove(basePath); + if (view != null) { + view.close(); + } + } + + /** + * Main API to get the file-system view for the base-path + * @param basePath + * @return + */ + public HoodieView getFileSystemView(String basePath) { + return globalViewMap.computeIfAbsent(basePath, + (path) -> viewCreator.apply(path, viewConfig)); + } + + /** + * Closes all views opened + */ + public void close() { + this.globalViewMap.values().stream().forEach(v -> v.close()); + this.globalViewMap.clear(); + } + + // FACTORY METHODS FOR CREATING FILE-SYSTEM VIEWS + + /** + * Create RocksDB based file System view for a dataset + * @param conf Hadoop Configuration + * @param viewConf View Storage Configuration + * @param basePath Base Path of dataset + * @return + */ + private static RocksDbBasedFileSystemView createRocksDBBasedFileSystemView(SerializableConfiguration conf, + FileSystemViewStorageConfig viewConf, String basePath) { + HoodieTableMetaClient metaClient = new HoodieTableMetaClient(conf.get(), basePath, true); + HoodieTimeline timeline = metaClient.getActiveTimeline().filterCompletedAndCompactionInstants(); + return new RocksDbBasedFileSystemView(metaClient, timeline, viewConf); + } + + /** + * Create a spillable Map based file System view for a dataset + * @param conf Hadoop Configuration + * @param viewConf View Storage Configuration + * @param basePath Base Path of dataset + * @return + */ + private static SpillableMapBasedFileSystemView createSpillableMapBasedFileSystemView(SerializableConfiguration conf, + FileSystemViewStorageConfig viewConf, String basePath) { + logger.warn("Creating SpillableMap based view for basePath " + basePath); + HoodieTableMetaClient metaClient = new HoodieTableMetaClient(conf.get(), basePath, true); + HoodieTimeline timeline = metaClient.getActiveTimeline().filterCompletedAndCompactionInstants(); + return new SpillableMapBasedFileSystemView(metaClient, timeline, viewConf); + } + + + /** + * Create an in-memory file System view for a dataset + * @param conf Hadoop Configuration + * @param viewConf View Storage Configuration + * @param basePath Base Path of dataset + * @return + */ + private static HoodieTableFileSystemView createInMemoryFileSystemView(SerializableConfiguration conf, + FileSystemViewStorageConfig viewConf, String basePath) { + logger.warn("Creating InMemory based view for basePath " + basePath); + HoodieTableMetaClient metaClient = new HoodieTableMetaClient(conf.get(), basePath, true); + HoodieTimeline timeline = metaClient.getActiveTimeline().filterCompletedAndCompactionInstants(); + return new HoodieTableFileSystemView(metaClient, timeline); + } + + /** + * Create a remote file System view for a dataset + * @param conf Hadoop Configuration + * @param viewConf View Storage Configuration + * @param metaClient Hoodie Table MetaClient for the dataset. + * @return + */ + private static RemoteHoodieTableFileSystemView createRemoteFileSystemView(SerializableConfiguration conf, + FileSystemViewStorageConfig viewConf, HoodieTableMetaClient metaClient) { + logger.info("Creating remote view for basePath " + metaClient.getBasePath() + ". Server=" + + viewConf.getRemoteViewServerHost() + ":" + viewConf.getRemoteViewServerPort()); + return new RemoteHoodieTableFileSystemView(viewConf.getRemoteViewServerHost(), + viewConf.getRemoteViewServerPort(), metaClient); + } + + /** + * Main Factory method for building file-system views + * @param conf Hadoop Configuration + * @param config View Storage Configuration + * @return + */ + public static FileSystemViewManager createViewManager( Review comment: Can you add a little more description on the entity-relation diagram for embedded, spillable, memory vs REMOTE and REMOTE_FIRST and how they work together ? ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org With regards, Apache Git Services
