Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

139 lines
3.4 KiB
Markdown
Raw Normal View History

2023-08-11 07:25:08 +02:00
---
title: Run the Domo Pipeline Connector Externally
slug: /connectors/pipeline/domo-pipeline/yaml
---
# Run the Domo Pipeline Connector Externally
In this section, we provide guides and references to use the Domo Pipeline connector.
Configure and schedule Domo Pipeline metadata and profiler workflows from the OpenMetadata UI:
- [Requirements](#requirements)
- [Metadata Ingestion](#metadata-ingestion)
{% partial file="/v1.2/connectors/external-ingestion-deployment.md" /%}
2023-08-11 07:25:08 +02:00
## Requirements
{%inlineCallout icon="description" bold="OpenMetadata 0.12 or later" href="/deployment"%}
To deploy OpenMetadata, check the Deployment guides.
{% /inlineCallout %}
2023-12-20 10:30:23 +05:30
**Note:** For metadata ingestion, kindly make sure add atleast `data` scopes to the clientId provided.
2023-08-11 07:25:08 +02:00
Question related to scopes, click [here](https://developer.domo.com/portal/1845fc11bbe5d-api-authentication).
### Python Requirements
To run the Domo Pipeline ingestion, you will need to install:
```bash
pip3 install "openmetadata-ingestion[domo]"
```
## Metadata Ingestion
All connectors are defined as JSON Schemas.
[Here](https://github.com/open-metadata/OpenMetadata/blob/main/openmetadata-spec/src/main/resources/json/schema/entity/services/connections/pipeline/airbyteConnection.json)
you can find the structure to create a connection to Airbyte.
In order to create and run a Metadata Ingestion workflow, we will follow
the steps to create a YAML configuration able to connect to the source,
process the Entities if needed, and reach the OpenMetadata server.
The workflow is modeled around the following
[JSON Schema](https://github.com/open-metadata/OpenMetadata/blob/main/openmetadata-spec/src/main/resources/json/schema/metadataIngestion/workflow.json)
### 1. Define the YAML Config
This is a sample config for Domo-Pipeline:
{% codePreview %}
{% codeInfoContainer %}
#### Source Configuration - Service Connection
{% codeInfo srNumber=1 %}
**Client ID**: Client ID to Connect to DOMO Pipeline.
{% /codeInfo %}
{% codeInfo srNumber=2 %}
**Secret Token**: Secret Token to Connect DOMO Pipeline.
{% /codeInfo %}
{% codeInfo srNumber=3 %}
**Access Token**: Access to Connect to DOMO Pipeline.
{% /codeInfo %}
{% codeInfo srNumber=4 %}
**API Host**: API Host to Connect to DOMO Pipeline instance.
{% /codeInfo %}
{% codeInfo srNumber=5 %}
**Instance Domain**: URL to connect to your Domo instance UI. For example `https://<your>.domo.com`.
2023-08-11 07:25:08 +02:00
{% /codeInfo %}
{% partial file="/v1.2/connectors/yaml/pipeline/source-config-def.md" /%}
2023-08-11 07:25:08 +02:00
{% partial file="/v1.2/connectors/yaml/ingestion-sink-def.md" /%}
2023-08-11 07:25:08 +02:00
{% partial file="/v1.2/connectors/yaml/workflow-config-def.md" /%}
2023-08-11 07:25:08 +02:00
{% /codeInfoContainer %}
{% codeBlock fileName="filename.yaml" %}
```yaml
source:
type: domopipeline
serviceName: domo-pipeline_source
serviceConnection:
config:
type: DomoPipeline
```
```yaml {% srNumber=1 %}
clientID: clientid
```
```yaml {% srNumber=2 %}
secretToken: secret-token
```
```yaml {% srNumber=3 %}
accessToken: access-token
```
```yaml {% srNumber=4 %}
apiHost: api.domo.com
```
```yaml {% srNumber=5 %}
instanceDomain: https://<your>.domo.com
2023-08-11 07:25:08 +02:00
```
{% partial file="/v1.2/connectors/yaml/pipeline/source-config.md" /%}
2023-08-11 07:25:08 +02:00
{% partial file="/v1.2/connectors/yaml/ingestion-sink.md" /%}
2023-08-11 07:25:08 +02:00
{% partial file="/v1.2/connectors/yaml/workflow-config.md" /%}
2023-08-11 07:25:08 +02:00
{% /codeBlock %}
2023-08-11 07:25:08 +02:00
{% /codePreview %}
2023-08-11 07:25:08 +02:00
{% partial file="/v1.2/connectors/yaml/ingestion-cli.md" /%}