How to configure an X-Hive/DB Connection

 

Figure 13.16. The Configure Connection Dialog

The Configure Connection Dialog

 
  1. Go to Preferences -> Data Sources. In the Connections panel click the New button.

  2. Enter a unique name for this connection and select one of the previously configured X-Hive DB data sources from the Data Source combo box.

  3. Fill-in the Connection Details:

    URL

    The URL property for X-Hive connection. It is also called xhive.bootstrap and specifies the location of the X-Hive/DB federation.

    This property can be used in two different ways:

    If the property is a URL of the form xhive://host:port, the X-Hive/DB connection will attempt to connect to an X-Hive/DB server running behind the specified TCP/IP port.

    If the property is the complete (or relative) path to an XhiveDatabase.bootstrap file, an X-Hive/DB server will be started in the current JVM. Depending on the application, this can be much faster than using a remote server because the communication overhead is avoided. However, only one JVM can run an X-Hive/DB server for a specific federation at the same time.

    For the second case (using a bootstrap file to connect) you need to add additional JAR files when you configure the data source.

    User

    User name to access the X-Hive/DB database engine.

    Password

    Password to access the X-Hive/DB database engine.

    Database

    The name of the database to access from the X-Hive/DB database engine.

    Run XQuery in read/write session (with committing)

    If checked the X-Hive session ends with a commit, otherwise it ends with a rollback.

  4. Click OK.