DocumentationExperience PlatformSource Connectors Guide

Configure explore specifications for Self-Serve Sources (Batch SDK)

Last update: Wed Aug 09 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Developer
  • User
  • Admin
  • Leader

Explore specifications defines the parameters required for exploring and inspecting objects contained in your source. Explore specifications also defines the response format returned when objects are explored and inspected.

TIP
Explore specifications are hard-coded and you can simply copy and paste the payload below to your connection specification.
"exploreSpec": {
  "name": "Resource",
  "type": "Resource",
  "requestSpec": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object"
  },
  "responseSpec": {
    "$schema": "http: //json-schema.org/draft-07/schema#",
    "type": "object",
    "properties": {
      "format": {
        "type": "string"
      },
      "schema": {
        "type": "object",
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "data": {
        "type": "array",
        "items": {
          "type": "object"
        }
      }
    }
  }
}
Explore specifications
Description
Example
name
Defines the name or identifier of the explore specification.
Resource
type
Defines the type of the explore specification.
Resource
requestSpec
Contains the parameters required to explore objects in the connection.
requestSpec.type
Defines the data type of the request specification.
object
responseSpec
Contains the parameters that define the format of the response message returned against an explore call.
responseSpec.type
Defines the data type of the response specification.
object
responseSpec.properties
Contains information pertaining to how the response message is formatted.
responseSpec.properties.format
Defines the formatting of the response schema.
object
responseSpec.properties.format.type
Defines the data type of properties.
string
responseSpec.schema
Contains information pertaining to how the response schema is formatted.
responseSpec.schema.type
Defines the data type of the schema.
object
responseSpec.schema.properties
Contains information on the columns, type, and items held within a schema.
responseSpec.schema.properties.columns.items.properties.name
Displays the name of the file.
responseSpec.schema.properties.columns.items.properties.name.type
Defines the data type of the file name.
string

Next steps

With your explore specifications populated, you can proceed to create a complete connection specification using the Flow Service API. See the Self-Serve Sources (Batch SDK) API guide for more information.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089