The RelationalAI Software Development Kit for Go enables developers to access the RAI REST APIs from Go.
- You can find RelationalAI Go SDK documentation at https://docs.relational.ai/rkgms/sdk/go-sdk
- You can find RelationalAI product documentation at https://docs.relational.ai
- You can learn more about RelationalAI at https://relational.ai
- Go 1.18+
cd ./rai
go build
./run-tests
Note, the test are run against the account configured in your SDK config file.
The tests take several optional arguments, which can make iterating and debugging easier.
./run-tests -args <arguments>
Argument | Description |
---|---|
-d <database> | Test database name |
-e <engine> | Test engine name |
-s <size> | Test engine size |
-c <client> | Test OAuth client name |
-u <user> | Test user email address |
-no-teardown | Don't teardown test resouces |
-show-query | Show query string for all results tests |
The -no-teardown
option can be helpful when iterating on tests, because
when combined with a given engine name, it avoids recreating the engine on
every test run.
The -show-query
option is useful when narrowing down failures in the results
tests.
And these can also be passed directly to go test
.
In order to run the examples you will need to create an SDK config file.
The default location for the file is $HOME/.rai/config
and the file should
include the following:
Sample configuration using OAuth client credentials:
[default]
host = azure.relationalai.com
client_id = <your client_id>
client_secret = <your client secret>
# the following are all optional, with default values shown
# port = 443
# scheme = https
# client_credentials_url = https://login.relationalai.com/oauth/token
Client credentials can be created using the RAI console at https://console.relationalai.com/login
You can copy config.spec
from the root of this repo and modify as needed.
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
export PATH=$PATH:$HOME/go/bin
protoc -I protos --go_out=. --go_opt=Mschema.proto=./rai/pb --go_opt=Mmessage.proto=./rai/pb protos/*.proto
The SDK contains examples for every API, and various other SDK features. These
are located in ./examples
folder.
Each example can be run using the go
command.
cd ./examples
go run get_database/main.go -d sdk-test
There is also a bash script in ./examples
that can be used to run
individual examples.
cd ./examples
./run get_database -d sdk-test
You can reach the RAI developer support team at support@relational.ai
We value feedback and contributions from our developer community. Feel free to submit an issue or a PR here.
The RelationalAI Software Development Kit for Go is licensed under the Apache License 2.0. See: https://github.com/RelationalAI/rai-sdk-go/blob/master/LICENSE