Connection
左ナビゲーションのManageグループからConnectionを開きます。
接続設定はウェアハウスタイプによって異なります:
| Warehouse type | Network access |
|---|---|
| SaaS | Public Link(インターネット、IP許可リストで保護)またはPrivateLink(VPC内のプライベートバックボーン)を選択してください。 |
| BYOC | クラウドネットワークが接続性を提供します。Public Access Allowlistを介してデータプレーンアクセスを管理してください。 |
Connection Info
Connection Infoパネルは、アプリケーションがウェアハウスに接続するために必要な詳細を表示します。
| Field | Description |
|---|---|
| Warehouse ID | ウェアハウスの一意識別子。 |
| Domain / IP | MySQLおよびHTTP接続用のホスト名またはIPアドレス。 |
| MySQL Protocol Port | デフォルト:9030。 |
| HTTP Protocol Port | デフォルト:8080。 |
| Username | データベースユーザー名。デフォルトの管理者ユーザーはadminです。 |
| Password | データベースパスワード。編集アイコンをクリックしてリセットしてください。 |
Public Link
SaaSウェアハウスのみ。 Public Linkは、IP許可リストで保護されたパブリックインターネット経由でウェアハウスを公開します。
Connectionページで、Public Linkタブに切り替えます。IP Allowlistセクションに現在のアクセスポリシーが表示されます。Edit IP Allowlistをクリックして、送信元IPとCIDRブロックを追加または削除してください。


Note デフォルトエントリは
0.0.0.0/0で、どこからでもアクセスを許可します。露出を減らすために、できるだけ早くこれを削除し、実際の送信元IPを追加してください。
PrivateLink
SaaSウェアハウスのみ。 PrivateLinkは、自身のVPC内のアプリケーションが、ネットワークアーキテクチャを簡素化し、パブリックアクセスのリスクを回避しながら、プライベートネットワーク経由でVPCの境界を越えてVeloDB Cloudにアクセスできるようにします。
PrivateLink接続には2つの端点があります:Endpoint Service(パブリッシャー側)とEndpoint(コンシューマー側)。誰が誰に接続するかによって、2つの端点は異なって所有されます:
- VPCからVeloDBにアクセス:VeloDB CloudがEndpoint Serviceを所有・管理し、自身のVPCでEndpointを作成・管理します。
- VeloDBがVPCにアクセス:自身のVPCでEndpoint Serviceを所有し、VeloDB CloudがEndpointを作成・管理します。
Note VeloDB CloudはPrivateLinkに対して追加料金を請求しませんが、エンドポイントインスタンスとトラフィックについてはクラウドプロバイダーに支払います。
VPCからVeloDBにアクセス

この方向を使用して、VPC内のレポートツール、BI、ログ分析ジョブ、その他のアプリケーションがVeloDB Cloudウェアハウスにアクセスできるようにします。
AWS上で
-
対象ウェアハウスで、Connection → Private Linkを開き、Connect Your VPC to VeloDBの下のSet up Connectionをクリックします。

-
Set up one or more endpointsをクリックして、AWS PrivateLinkを開き、エンドポイントを作成します。

-
AWS PrivateLinkコンソールで、リージョンがVeloDBウェアハウスのリージョンと一致することを確認し(PrivateLinkはリージョンスコープです)、Create endpointをクリックします。

Note VeloDBエンドポイントサービスへのアクセスが許可リストに登録されたプリンシパルでAWSにサインインしてください。そうでなければ、サービス名の検証が失敗します。
-
エンドポイントフォームを入力します:


Parameter Description Name tag オプション。キー Nameと任意の値でタグ付けします。Service category 必須。Endpoint services that use NLBs and GWLBsを選択してください。 Service name 必須。VeloDB CloudのEndpoint Service情報パネルからService Nameをコピーし、ここに貼り付けてVerify serviceをクリックします。 VPC 必須。エンドポイントを作成するVPC。 Subnets 必須。VeloDBのエンドポイントサービスと同じAZ(PrivateLinkの制限)。適切なサブネットを選択してください。 Security groups 必須。ルールは、ウェアハウスが使用するプロトコルとポート、およびアプリケーションの送信元IPを許可する必要があります。 Tags オプション。 -
エンドポイントのステータスがPendingからAvailableに変わったら、private-linkハンドシェイクが完了です。

-
VeloDB CloudConnectionページを更新します。エンドポイントリストに接続詳細が表示されます。


Note Find DNS NameをクリックしてAWSのエンドポイント詳細ページを開き、DNS Nameを取得して、ウェアハウスへのアクセスに使用してください。
-
アプリケーションは、MySQLまたはHTTPを使用してそのDNS名経由でウェアハウスに接続します。ConnectionページのConnection Examplesポップオーバーには、すぐに使えるスニペットが表示されます。

Note
- VeloDB Cloudは2つの独立したアカウントシステムを使用しています:Console accounts(VeloDB Cloudコンソールへのサインイン)とDatabase accounts(ウェアハウスへの接続に使用)。このセクションはデータベースアカウントについてです。
- 最初の接続では、adminユーザーを使用してください。Settingsページからパスワードを初期化またはリセットできます。
Azure上で
-
対象ウェアハウスで、Connection → Private Linkを開き、Access VeloDB from Your VPCの下のNew Connectionをクリックします。
-
Set up one or more endpointsをクリックして、Azure PrivateLinkを開きます。

-
Basicsタブで、リージョンがVeloDBウェアハウスと一致することを確認してフォームを入力し、Next: Resourceをクリックします。

Parameter Category Description Subscription Project details アクセスに使用するサブスクリプション。 Resource group Project details プライベートエンドポイント用のリソースグループ。適切なものがない場合は作成してください。 Name Instance details プライベートエンドポイントインスタンス名。 Network Interface Name Instance details インスタンス名から自動生成されます;編集可能です。 Region Instance details ウェアハウスリージョンと一致する必要があります。 -
Resourceタブで、Connect to an Azure resource by resource ID or aliasを選択し、VeloDBエンドポイントサービス情報パネルからService Aliasを貼り付け、Next: Virtual Networkをクリックします。

-
Virtual Networkタブで、エンドポイント用のVNetとサブネットを選択し、Next: DNSをクリックします。

-
DNSとTagsタブでは、デフォルトを保持してください(プライベート接続にはDNSレコードが必要です。AzureのPrivate DNSガイダンスを参照してください)。確認してCreateをクリックします。



-
エンドポイントのステータスがCreatedからOKに変わったら、ハンドシェイクが完了です。


-
VeloDB CloudConnectionページを更新します。エンドポイントリストに接続詳細が表示されます。

-
エンドポイントリストのFind DNS Nameをクリックして、エンドポイントのIPまたはDNS名を取得します。

-
ConnectionページのConnection Examplesポップオーバーを使用して、MySQLとHTTPをカバーするスニペットを取得してください。

VeloDBがVPCにアクセス

この方向は、VeloDBがVPC内のリソース(例えば、インポート用のデータソース)から読み取る必要がある場合に使用します。
Note VeloDBのプライベートネットワークアクセスによって発生するエンドポイントインスタンスとトラフィック料金は、現在ユーザーに請求されていません。
AWS上で
-
対象ウェアハウスで、Connection → Private Linkを開き、Grant VeloDB Access to Your VPCの下のNew Connectionをクリックします。
-
ページにはウェアハウスのCurrent RegionとARN of VeloDBが表示されます。Set up endpoint servicesをクリックして、AWS PrivateLinkコンソールを開きます。

-
AWSコンソールで、VPC → Endpoint servicesを開き、ウェアハウスと同じリージョンに切り替え、Create endpoint serviceをクリックします。

-
エンドポイントサービスを設定し、Createをクリックします。


適切なネットワークロードバランサーがない場合は、まずCreate Network Load Balancerをクリックし、フィルターして選択してください。




適切なターゲットグループがない場合は、まずCreate Target Groupをクリックし、更新してから選択してください。


-
エンドポイントサービスのAllow principalsタブで、ARN of VeloDBを追加します。


-
エンドポイントサービス詳細ページからService IDとService Nameをコピーし、VeloDB CloudのEndpoint Service登録ページに貼り付けます。

-
登録後、エンドポイントに名前を付けてCreate Nowをクリックします。

-
エンドポイントサービスのEndpoint connectionsタブで、エンドポイント接続リクエストを承認します。


-
更新して、エンドポイントのステータスがpendingAcceptanceからavailableに変わるまで待ちます。

Azure上で
-
対象ウェアハウスで、Connection → Private Linkを開き、Grant VeloDB Access to Your VPCの下のSet up Connectionをクリックします。
-
ページにはCurrent RegionとSubscription ID of VeloDBが表示されます。Set up endpoint servicesをクリックして、Azure Private Link Serviceコンソールを開きます。

-
Basicsタブで、リージョンがウェアハウスと一致することを確認してフォームを入力し、Next: Outbound settingsをクリックします。

Parameter Category Description Subscription Project details Private Link Service用のサブスクリプション。 Resource group Project details Private Link Serviceを配置するリソースグループ。 Name Instance details Private Link Serviceインスタンス名。 Region Instance details ウェアハウスリージョンと一致する必要があります。 -
Outbound settingsで、ロードバランサー、フロントエンドIP、ソースNATネットワーク/サブネットを選択し、Next: Access Securityをクリックします。

-
Access Securityで、Restricted by subscriptionを設定し、Subscription ID of VeloDBを許可リストに追加し、自動承認をYesに設定してから、Next: Tagsをクリックします。

-
Tagsでは、デフォルトを保持してください。確認してCreateをクリックします。


-
ステータスがCreatedからOKに変わったら、サービスが準備完了です。


-
Private Link Service詳細ページからResource IDとAliasをコピーし、VeloDB CloudのEndpoint Service登録ページに貼り付けます。


-
登録後、エンドポイントに名前を付けてCreate Nowをクリックします。

-
更新して、エンドポイントのステータスがpendingAcceptanceからApproveに変わるまで待ちます。


Public Access Allowlist
BYOCウェアハウスのみ。 コンソール経由でデータプレーン操作(クエリ、アップサート、フェッチ)を実行できるソースを制御します。コントロールプレーン操作(作成、削除、スケール等)は影響を受けず、この設定に関係なく完全にアクセス可能なままです。

Edit IP Allowlistをクリックして設定を開き、3つのオプションのうち1つを選択します:

| Option | Behavior |
|---|---|
| Anywhere | すべてのソースがウェアハウスにアクセスできます。 |
| Nowhere | コンソール経由でのデータプレーンアクセスはありません。 |
| Specific Locations | リストされたIPアドレスまたはCIDRブロックに制限します。 |
Connection strings
VeloDB CloudはMySQL ネットワーク接続プロトコルを使用し、MySQLコマンドラインツール、JDBC/ODBCドライバー、可視化ツールと互換性があります。
MySQLクライアント:
mysql -h <host> -P <port> -u <username> -p
JDBC:
jdbc:mysql://<host>:<port>/<database>?user=<username>&password=<password>
ウェアハウスに複数のクラスターがある場合、データベース名に@<cluster_name>を付加することで特定のクラスターにルーティングします:
jdbc:mysql://<host>:<port>/<database>@<cluster>?user=<username>&password=<password>
HTTP (Stream Load):
curl --location-trusted -u <username>:<password> \
-H "label:<load-label>" \
-H "column_separator:," \
-T data.csv \
http://<host>:<port>/api/<database>/<table>/_stream_load
特定のクラスターをターゲットにするには、cloud_clusterヘッダーを追加してください:
-H "cloud_cluster:<cluster>"
正確なホストとポートについては、接続ページのConnection Examplesポップオーバーを使用してください。