datahub - Meltano Hub

Datahub

datahub (datahub-project variant)

The datahub utility centrally track all your metadata assets pushing metadata to datahub.

Getting Started

Prerequisites

If you haven't already, follow the initial steps of the Getting Started guide:

Installation and configuration

Add the datahub utility to your project using
```
meltano add
```
:

meltano add utility datahub

Configure the datahub settings using

meltano config

meltano config datahub set --interactive

Next steps

Add a source and sink

Add additional metadata sources

You should override the pip url in your meltano config to include each of the plugins you want to use with the ingestion framework

Find the datahub plugin definition in your meltano.yml project file

Update the pip_url property to include the desired extras (plugins):

utilities:
- name: datahub
  variant: datahub-project
  pip_url: acryl-datahub[rest,mongodb,metabase,bigquery,bigquery-usage,dbt]

Re-install the plugin:
```
meltano install utility datahub
```

The next time you run datahub cli, you will be able to ingest metadata with the appropriate source definition as seen here.

This plugin ships with a dbt ingestion recipe via its file-bundle.

If you run into any issues, learn how to get help.

Capabilities

This plugin currently has no capabilities defined. If you know the capabilities required by this plugin, please contribute!

Settings

The datahub settings that are known to Meltano are documented below. To quickly find the setting you're looking for, click on any setting name from the list:

gms_host
gms_token

You can also list these settings using

meltano config

with the list subcommand:

meltano config datahub list

You can override these settings or specify additional ones in your meltano.yml by adding the settings key.

Please consider adding any settings you have defined locally to this definition on MeltanoHub by making a pull request to the YAML file that defines the settings for this plugin.

GMS Host (gms_host)

Environment variable: DATAHUB_GMS_HOST

URL of DataHub GMS endpoint. Typically this is something like your-server:8000 where your-server is the server IP or domain name. If using metadata service authentication enabled in the image env (recommended), then this should instead point to your frontend which acts as a proxy for the GMS service. datahub.yourdomain.com/api/gms

Configure this setting directly using the following Meltano command:

meltano config datahub set gms_host [value]

GMS Token (gms_token)

Environment variable: DATAHUB_GMS_TOKEN

Bearer token used for authentication. AKA Personal Access Token. Not needed if contacting GMS service directly.

Configure this setting directly using the following Meltano command:

meltano config datahub set gms_token [value]

Commands

The datahub utility supports the following commands that can be used with

meltano invoke

ingest-dbt

Equivalent to: ingest run --config ${MELTANO_PROJECT_ROOT}/utilities/datahub/dbt.dhub.yml

Push dbt metadata to datahub

meltano invoke datahub:ingest-dbt [args...]

Something missing?

This page is generated from a YAML file that you can contribute changes to.

Edit it on GitHub!

Looking for help?

If you're having trouble getting the datahub utility to work, look for an existing issue in its repository, file a new issue, or join the Meltano Slack community and ask for help in the

#plugins-general

channel.

Install

meltano add utility datahub

Maintenance Status

Repo

https://github.com/datahub-project/datahub

Maintainer

Meltano Stats

Keywords