Skip to main content

​
Go SDK

We now present a high-level Go API as a gentle wrapper to interact with the OpenMetadata API. The open-source OpenMetadata SDK for Go simplifies provisioning, managing, and using OpenMetadata resources from the Go application code.
The OpenMetadata SDK for Go modules build on top of the underlying OpenMetadata REST API, allows you to use those APIs through familiar Go paradigms. You can find the source code for the OpenMetadata libraries in the GitHub repository. As an open-source project, contributions are always welcome! You can add the module to your application with the below command 
go get github.com/open-metadata/openmetadata-sdk/openmetadata-go-client

​
Establish OpenMetadata Server Connection

To create OpenMetadata Gateway, you will need to establish a connection with OpenMetadata Server. The following inputs will be needed:
  • BaseURL: The url on which your instance of OpenMetadata is up and running (include the port if you need to e.g. http://localhost:8585).
  • APIVersion: pass an empty string — this will be v1 for now.
  • Retry: number of time the request should retry if the status code returned is in RetryCodes. Use 0 to use the default value
  • RetryWait: number of second to wait betwee retries. Pass 0 to use the default value
  • RetryCodes: HTTP status that will trigger a retry. Pass nil to use the default
  • AuthTokenMode: defaults to Bearer
  • AccessToken: JWT token use to authenticate the request
// main.go
package main

import (
	"github.com/open-metadata/openmetadata-sdk/openmetadata-go-client/pkg/ometa"
)

func main() {
    restConfig := ometa.NewRestConfig(
		"http://localhost:8585",
		"", // APIVersion
		0, // Retry -> defaults to 3
		0, // RetryWait -> defaults to 30 seconds
		nil, // RetryCodes -> defaults to [429, 504]
		"JWTToken",
	)
}

​
Create OpenMetadata Gateway

Once the connection details are provided, you can create an OpenMetadata Gateway using the following piece of code. 
// main.go
...

func main() {
    ...
    rest := ometa.NewRest(restConfig)
}