Jump to main content
HPE Ezmeral Data Fabric 6.2 Documentation
  • About Release 6.2
  • 6.2 Installation
  • 6.2 Platform
  • 6.2 Administration
  • 6.2 Development
  • Other Docs
  1. Home
  2. 6.2 Development

    This section contains information related to application development for ecosystem components and MapR products including HPE Ezmeral Data Fabric Database (binary and JSON), filesystem, and MapR Streams.

  3. HPE Ezmeral Data Fabric Database and Apps

    This section contains information about developing client applications for JSON and binary tables.

  4. Developing Applications for JSON Tables

    As part of its support for JSON tables, HPE Ezmeral Data Fabric Database implements the OJAI API. The OJAI API provides methods for creating, reading, updating, and deleting JSON documents in HPE Ezmeral Data Fabric Database JSON tables. It is available in Java, and starting in MEP 6.0, also available in Node.js, Python, C#, and Go. HPE Ezmeral Data Fabric Database also provides a HPE Ezmeral Data Fabric Database JSON Client API for managing JSON tables and a HPE Ezmeral Data Fabric Database JSON REST API for performing basic operations using HTTP calls.

  5. Using the Java OJAI Client

    This topic describes HPE Ezmeral Data Fabric Database 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.

HPE Ezmeral Data Fabric 6.2 Documentation
  • 6.2 Development

    This section contains information related to application development for ecosystem components and MapR products including HPE Ezmeral Data Fabric Database (binary and JSON), filesystem, 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.

    • filesystem and Apps

      The following sections provide information about accessing filesystem with C and Java applications.

    • HPE Ezmeral Data Fabric Database 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 HPE Ezmeral Data Fabric Database table (binary or JSON).

      • Passing the HPE Ezmeral Data Fabric Database Table Path

        This topic describes the methods for passing a HPE Ezmeral Data Fabric Database 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

        HPE Ezmeral Data Fabric Database provides a C API, libMapRClient and partially supports the Apache HBase 1.1 Java APIs for performing operation on HPE Ezmeral Data Fabric Database binary tables.

      • Setting for OJAI Applications to Use Data Fabric Client Features

        Describes how to set the classpath for OJAI applications to use data-fabric client features.

      • Developing Applications for JSON Tables

        As part of its support for JSON tables, HPE Ezmeral Data Fabric Database implements the OJAI API. The OJAI API provides methods for creating, reading, updating, and deleting JSON documents in HPE Ezmeral Data Fabric Database JSON tables. It is available in Java, and starting in MEP 6.0, also available in Node.js, Python, C#, and Go. HPE Ezmeral Data Fabric Database also provides a HPE Ezmeral Data Fabric Database JSON Client API for managing JSON tables and a HPE Ezmeral Data Fabric Database 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 HPE Ezmeral Data Fabric Database JSON Client API library or HPE Ezmeral Data Fabric Database Shell commands.

        • Managing JSON Documents

          To perform CRUD operations (create, read, update, and delete) on JSON documents in HPE Ezmeral Data Fabric Database 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 HPE Ezmeral Data Fabric Database JSON tables using the OJAI API library and HPE Ezmeral Data Fabric Database Shell. It includes sample programs using the OJAI API library and shows how to run the same queries in HPE Ezmeral Data Fabric Database Shell.

        • Querying with HPE Ezmeral Data Fabric Database Shell

          This section describes how to query JSON documents using either the find or findbyid command in HPE Ezmeral Data Fabric Database 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 HPE Ezmeral Data Fabric Database Shell (dbshell) commands.

        • Using the Java OJAI Client

          This topic describes HPE Ezmeral Data Fabric Database 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.

          • Compiling and Running Java OJAI Applications

            For applications that use the Java OJAI API, use Maven to compile and determine the application's dependencies. Then, when you run the application, specify those dependencies in the application's classpath.

          • Reading Your Own Writes in Java OJAI

            The Java OJAI DocumentStore and Query APIs provide the ability to track writes to JSON tables. Use these APIs to ensure your application reads recent writes on JSON tables with secondary indexes.

          • Setting Query Options in Java OJAI

            This topic describes how to set query options in your Java OJAI application.

          • Enabling Buffered Writes in Java OJAI

            By default, HPE Ezmeral Data Fabric Database JSON does not buffer writes. You can improve performance by enabling buffered writes in your Java OJAI application.

        • Using the Java OJAI Thin Client

          Starting with MEP 6.3.0, you can use the Java OJAI Thin Client to write HPE Ezmeral Data Fabric Database JSON applications. The Java OJAI Thin Client provides a lightweight library that supports the OJAI API. You can connect to HPE Ezmeral Data Fabric Database JSON, and add, update, and query documents in a HPE Ezmeral Data Fabric Database JSON table.

        • Using the Node.js OJAI Client

          Starting with MEP 6.0, you can use the Node.js OJAI client to write HPE Ezmeral Data Fabric Database JSON applications. The client provides you with a lightweight library that supports the OJAI API. You can connect to HPE Ezmeral Data Fabric Database JSON from middleware components, and add, update, and query documents in a HPE Ezmeral Data Fabric Database JSON table.

        • Using the Python OJAI Client

          Starting with MEP 6.0, you can use the Python OJAI client to write HPE Ezmeral Data Fabric Database JSON applications. The client provides you with a lightweight library that supports the OJAI API. You can connect to HPE Ezmeral Data Fabric Database JSON, and add, update, and query documents in a HPE Ezmeral Data Fabric Database JSON table.

        • Using the C# OJAI Client

          Starting with MEP 6.1.0, you can use the C# OJAI client to write HPE Ezmeral Data Fabric Database JSON applications. The client provides you with a lightweight library that supports the OJAI API. You can connect to HPE Ezmeral Data Fabric Database JSON, and add, update, and query documents in a HPE Ezmeral Data Fabric Database JSON table.

        • Using the Go OJAI Client

          Starting with MEP 6.0.0, you can use the Go OJAI client to write HPE Ezmeral Data Fabric Database JSON applications. The client provides you with a lightweight library that supports the OJAI API. You can connect to HPE Ezmeral Data Fabric Database JSON, and add, update, and query documents in a HPE Ezmeral Data Fabric Database JSON table.

        • Using the HPE Ezmeral Data Fabric Database JSON REST API

          Starting in the MEP 5.0 release, you can use a REST API to access HPE Ezmeral Data Fabric Database JSON tables. The REST API allows you to use HTTP calls to perform basic operations on HPE Ezmeral Data Fabric Database JSON tables.

        • HPE Ezmeral Data Fabric Database 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.

    • HPE Ezmeral Data Fabric Event Store and Apps

      HPE Ezmeral Data Fabric Event Store brings integrated publish and subscribe messaging to the MapR Converged Data Platform.

    • MapReduce and Apps

      This section contains information associated with developing YARN applications.

    • Kubernetes Interfaces for Data Fabric

      This section describes how to leverage the capabilities of the Kubernetes Interfaces for Data Fabric.

    • Ecosystem Components

      The following sections provide information about each open-source project that is supported by the HPE Ezmeral Data Fabric.

    • Maven and the HPE Ezmeral Data Fabric

      This section discusses topics associated with Maven and the HPE Ezmeral Data Fabric.

    • Developer's Reference

      This section contains in-depth information for the developer.

    • API Documentation

      HPE Ezmeral Data Fabric supports public APIs for filesystem, HPE Ezmeral Data Fabric Database, and HPE Ezmeral Data Fabric Event Store. These APIs are available for application-development purposes.

Using the Java OJAI Client

This topic describes HPE Ezmeral Data Fabric Database 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.

Additional Resources

Examples: https://github.com/mapr-demos/ojai-examples/tree/master/java/src/main/java/com/mapr/ojai/examples

  • Compiling and Running Java OJAI Applications
    For applications that use the Java OJAI API, use Maven to compile and determine the application's dependencies. Then, when you run the application, specify those dependencies in the application's classpath.
  • Reading Your Own Writes in Java OJAI
    The Java OJAI DocumentStore and Query APIs provide the ability to track writes to JSON tables. Use these APIs to ensure your application reads recent writes on JSON tables with secondary indexes.
  • Setting Query Options in Java OJAI
    This topic describes how to set query options in your Java OJAI application.
  • Enabling Buffered Writes in Java OJAI
    By default, HPE Ezmeral Data Fabric Database JSON does not buffer writes. You can improve performance by enabling buffered writes in your Java OJAI application.
(Topic last modified: 2019-09-06)
©Copyright 2021 Hewlett Packard Enterprise Development LP -
Partners | Support | Dev-Hub | Community | Training | Blog | My Account | ALA | Privacy Policy | Glossary