Home
6.0 Development
This section contains information related to application development for ecosystem components and MapR products including MapR-DB (binary and JSON), MapR-FS, and MapR Streams.
MapR-DB and Apps
This section contains information about developing client applications for JSON and binary tables.
Developing Applications for JSON Tables
As part of its support for JSON tables, MapR-DB implements the OJAI API. The OJAI API provides methods for creating, reading, updating, and deleting JSON documents in MapR-DB JSON tables. It is available in Java. MapR-DB also provides a MapR-DB JSON Client API for managing JSON tables and a MapR-DB JSON REST API for performing basic operations using HTTP calls.
Managing JSON Tables
This section describes how to create, list, and delete JSON tables, alter JSON table attributes, set permissions, and manage column families. You can perform these operations using either the MapR-DB JSON Client API library or MapR-DB Shell commands.

MapR 6.0 Documentation

6.0 Development
This section contains information related to application development for ecosystem components and MapR products including MapR-DB (binary and JSON), MapR-FS, and MapR Streams.
- Application Development Process
  Before you start developing applications on MapR’s Converged Data Platform, consider how you will get the data onto the platform, the format it will be stored in, the type of processing or modeling that is required, and how the data will be accessed.
- MapR-FS and Apps
  The following sections provide information about accessing MapR-FS with C and Java applications.
- MapR-DB and Apps
  This section contains information about developing client applications for JSON and binary tables.
  - Installing the mapr-client Package
    The mapr-client package must be installed on each node where you will be building and running your applications. This package installs all of the MapR Libraries needed for application development regardless of programming language or type of MapR-DB table (binary or JSON).
  - Passing the MapR-DB Table Path
    This topic describes the methods for passing a MapR-DB table name. Binary table names can be passed by either specifying the table path in the API or by setting the table path in the core-site.xml file. JSON table names are passed by specifying the table path in the API.
  - Tuning Parameters for Client Apps
    Though tuning client applications is generally not necessary, MapR does offer tuning parameters to change the behavior of client-side caching.
  - Developing Applications for Binary Tables
    MapR-DB provides a C API, libMapRClient and partially supports the Apache HBase 1.1 Java APIs for performing operation on MapR-DB binary tables.
  - Developing Applications for JSON Tables
    As part of its support for JSON tables, MapR-DB implements the OJAI API. The OJAI API provides methods for creating, reading, updating, and deleting JSON documents in MapR-DB JSON tables. It is available in Java. MapR-DB also provides a MapR-DB JSON Client API for managing JSON tables and a MapR-DB JSON REST API for performing basic operations using HTTP calls.
    - Sandbox Tutorial for JSON
      This section provides a tutorial that will help you build a Java application using the MapR-DB JSON Java API library.
    - Managing JSON Tables
      This section describes how to create, list, and delete JSON tables, alter JSON table attributes, set permissions, and manage column families. You can perform these operations using either the MapR-DB JSON Client API library or MapR-DB Shell commands.
      - Creating JSON Tables
        This topic describes how to create MapR-DB JSON tables using either programmatic APIs or dbshell.
      - Listing JSON Tables
        This topic describes how to list the JSON tables by using either the MapR-DB JSON Client API or MapR-DB Shell.
      - Altering JSON Table Attributes
        This topic describes how to change the values of table attributes by using the MapR-DB JSON Client API.
      - Deleting JSON Tables
        This topic describes how to delete MapR-DB JSON tables using either programmatic APIs or dbshell.
      - Permission Types for Fields and Column Families in JSON Tables
        By using access-control expressions (ACEs), you can grant or deny access to fields and column families that are in JSON tables.
      - Managing Column Families
        JSON tables store data in column families, which are collections of fields that are stored together on disk.
    - Managing JSON Documents
      To perform CRUD operations (create, read, update, and delete) on JSON documents in MapR-DB JSON tables using the OJAI API, you use Document, DocumentStore, and DocumentMutation objects.
    - Querying JSON Documents
      This section describes how to query JSON documents in MapR-DB JSON tables using the OJAI API library and MapR-DB Shell. It includes sample programs using the OJAI API library and shows how to run the same queries in MapR-DB Shell.
    - Querying with MapR-DB Shell
      This section describes how to query JSON documents using either the find or findbyid command in MapR-DB Shell (dbshell). It introduces the functionality the find command supports and describes the two ways to specify your queries. It also provides links to reference pages and examples.
    - Examples: Querying JSON Documents
      This section provides query examples using the OJAI API. The examples include querying by document ID, retrieving all documents in a store, selecting individual fields, specifying query conditions, and ordering your query result. For reference, the examples also include the equivalent MapR-DB Shell (dbshell) commands.
    - Using the Java OJAI Client
      This topic describes MapR-DB functionality that is applicable to only the Java OJAI client. This includes instructions on how to compile your Java OJAI application, enable buffered writes, use the read your own writes feature, and enable available query options.
    - Using the MapR-DB JSON REST API
      Starting in the MEP 5.0 release, you can use a REST API to access MapR-DB JSON tables. The REST API allows you to use HTTP calls to perform basic operations on MapR-DB JSON tables.
    - MapR-DB JSON MapReduce API
      This API library extends the Apache Hadoop MapReduce framework, so that you can write your own MapReduce applications to write data from one JSON table to another.
- MapR-ES and Apps
  MapR-ES brings integrated publish and subscribe messaging to the MapR Converged Data Platform.
- MapReduce and Apps
  This section contains information associated with developing YARN applications.
- MapR Data Science Refinery
  The MapR Data Science Refinery is an easy-to-deploy and scalable data science toolkit with native access to all platform assets and superior out-of-the-box security.
- MapR Data Fabric for Kubernetes FlexVolume Driver
  This section describes how to use and troubleshoot the MapR Data Fabric for Kubernetes FlexVolume Driver.
- Ecosystem Components
  The following sections provide information about each open source project that MapR supports.
- Maven and MapR
  This section discusses topics associated with Maven and MapR.
- Developer's Reference
  This section contains in-depth information for the developer.
- API Documentation
  MapR supports public APIs for MapR-FS, MapR-DB, and MapR-ES. These APIs are available for application development purposes.

Managing JSON Tables

This section describes how to create, list, and delete JSON tables, alter JSON table attributes, set permissions, and manage column families. You can perform these operations using either the MapR-DB JSON Client API library or MapR-DB Shell commands.

MapR-DB JSON Client API

Admin API

Use the methods in this interface to perform these tasks:

Create JSON tables
Alter JSON tables
Delete JSON tables
List JSON tables in a folder
See if a JSON table exists

For a full list of methods, see the MapR Admin interface

TableDescriptor API

Use the methods in this interface to perform these tasks:

Create tables with non-default values for one or more of their parameters
Alter tables

For a full list of interfaces and methods, see the MapR TableDescriptor interface.

MapR-DB Shell

The mapr dbshell is a tool for the creation and lightweight manipulation of JSON tables and documents. To run dbshell, enter mapr dbshell on the command line after logging into a node in a MapR cluster. See MapR-DB Shell (JSON Tables) for more information.