Using the Driver : Configuring the Relational Map : Using the REST Sample Path Method

Using the REST Sample Path Method

The REST Sample Path method allows you to access data for a single endpoint with minimal configuration.

To configure the driver to using the REST Sample Path method:

Set the REST Sample Path (RestSamplePath) option to specify the endpoint to which you want to connect and sample. For example, https://example.com/countries/.

Optionally, if you want to store the relational map in a resolved REST file, set the Create Map (CreateMap) option to either of the following values:

1 (ForceNew): The driver deletes the current REST file, internal configuration files, and relational map in the location specified by the Schema Map (SchemaMap) option and creates a new set at the same location.

2 (NotExist): The driver uses the current REST file, internal files, and relational map in the location specified by the Schema Map option. If the files do not exist, the driver creates them.

Note that if no value is specified for Create Map, the driver defaults to using internal memory to store the map (CreateMap=3).

Optionally, if you are storing the relational map to a REST file (CreateMap=1 | 2) , you can set the Schema Map option to specify the location to generation the REST and internal driver files. The default location depends on your platform:

For Windows:

<application_data_folder>\Local\Progress\DataDirect\AutoREST_Schema\

For Linux:

~/progress/datadirect/AutoREST_Schema/

Optionally, set the values for any required authentication options. See "Authentication" for details.

For example, the following examples demonstrate the minimum connection options to configure the REST Sample Path method:

Using a connection string:

DRIVER=DataDirect 8.0 Autonomous REST Connector;
RestSamplePath='https://example.com/countries/';

Using an odbc.ini file:

Driver=ODBCHOME/lib/ivautorestxx.so
RestSamplePath=https://example.com/countries/