Build and Configure Continuous Integration Projects

Suggest source assets matching criteria

Suggests source assets (DATABASE, SCHEMA, TABLE, TOPIC, KAFKA_SCHEMA) matching the provided search patterns for a pipeline.

Process Overview:

  1. Input Validation - Validates input parameters and permissions.
  2. Asset Discovery - Matches cataloged assets using provided regex patterns.
  3. Detailed Response - Returns full asset path details for the matching source resources.

Supported Asset Types:

  • DATABASE - RDBMS database assets
  • SCHEMA - RDBMS schema assets
  • TABLE - RDBMS table assets
  • TOPIC - Kafka topic assets
  • KAFKA_SCHEMA - Schema Registry subject assets

Use Cases:

  • Source asset selection and validation during pipeline setup.
  • Interactive workflows for asset discovery and filtering.

Required Permissions: Either replication-pipeline::create or replication-pipeline::update when permission harmonization is enabled; otherwise, replication-pipeline::manage.

post/v1/integration/continuous/projects/{projectId}/pipelines/{pipelineId}/suggest/source

Request

  • Base URL: https://integration-adapter.connect.cloud.precisely.com
  • URL: https://integration-adapter.connect.cloud.precisely.com/v1/integration/continuous/projects/{projectId}/pipelines/{pipelineId}/suggest/source
  • Auth: HTTP bearer

Path parameters

projectIdstring required

The unique identifier of the project containing the pipeline.

pipelineIdstring required

The unique identifier of the pipeline for which assets have to be selected.

Query parameters

type'DATABASE' | 'SCHEMA' | 'TABLE' | 'TOPIC' | 'KAFKA_SCHEMA' required

Type of source asset to match

Request body

databasestring

Optional: Database name for schema/table matching.

schemastring

Optional: Schema name for table matching.

patternsstring[] required

List of regex patterns for matching assets.

Response

List of matching assets along with context and fully qualified hierarchy

databasestring

Database name (for RDBMS assets)

schemastring

Schema name (for RDBMS assets)

tablestring

Table name (for RDBMS assets)

journalstring

Journal name (for DB2I/DB2LUW RDBMS assets)

topicstring

Kafka topic name (for Kafka assets)

subjectstring

Schema Registry subject (for Schema Registry assets)

Example response

{
  "database": "db1",
  "schema": "public",
  "table": "users",
  "journal": "user/journal",
  "topic": "user-events",
  "subject": "users-value"
}

Changes

No recorded changes to this operation across all 1 revision of this API.