メインコンテンツまでスキップ

Connection

左ナビゲーションのManageグループからConnectionを開きます。

接続設定はウェアハウスタイプによって異なります:

Warehouse typeNetwork access
SaaSPublic Link(インターネット、IP許可リストで保護)またはPrivateLink(VPC内のプライベートバックボーン)を選択してください。
BYOCクラウドネットワークが接続性を提供します。Public Access Allowlistを介してデータプレーンアクセスを管理してください。

Connection Info

Connection Infoパネルは、アプリケーションがウェアハウスに接続するために必要な詳細を表示します。

FieldDescription
Warehouse IDウェアハウスの一意識別子。
Domain / IPMySQLおよびHTTP接続用のホスト名またはIPアドレス。
MySQL Protocol Portデフォルト:9030
HTTP Protocol Portデフォルト:8080
Usernameデータベースユーザー名。デフォルトの管理者ユーザーはadminです。
Passwordデータベースパスワード。編集アイコンをクリックしてリセットしてください。

SaaSウェアハウスのみ。 Public Linkは、IP許可リストで保護されたパブリックインターネット経由でウェアハウスを公開します。

Connectionページで、Public Linkタブに切り替えます。IP Allowlistセクションに現在のアクセスポリシーが表示されます。Edit IP Allowlistをクリックして、送信元IPとCIDRブロックを追加または削除してください。

public link

public link ip allowlist

Note デフォルトエントリは0.0.0.0/0で、どこからでもアクセスを許可します。露出を減らすために、できるだけ早くこれを削除し、実際の送信元IPを追加してください。

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にアクセス

Access VeloDB from Your VPC

この方向を使用して、VPC内のレポートツール、BI、ログ分析ジョブ、その他のアプリケーションがVeloDB Cloudウェアハウスにアクセスできるようにします。

AWS上で

  1. 対象ウェアハウスで、Connection → Private Linkを開き、Connect Your VPC to VeloDBの下のSet up Connectionをクリックします。

    private link ad

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

    private link add endpoint

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

    private link create endpoint on aws

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

  4. エンドポイントフォームを入力します:

    private link create endpoint on aws01

    private link create endpoint on aws02

    ParameterDescription
    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オプション。
  5. エンドポイントのステータスがPendingからAvailableに変わったら、private-linkハンドシェイクが完了です。

    private link create endpoint on aws pending

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

    private link endpoint list table

    private link endpoint on aws details

    Note Find DNS NameをクリックしてAWSのエンドポイント詳細ページを開き、DNS Nameを取得して、ウェアハウスへのアクセスに使用してください。

  7. アプリケーションは、MySQLまたはHTTPを使用してそのDNS名経由でウェアハウスに接続します。ConnectionページのConnection Examplesポップオーバーには、すぐに使えるスニペットが表示されます。

    private link connection example

    Note

    • VeloDB Cloudは2つの独立したアカウントシステムを使用しています:Console accounts(VeloDB Cloudコンソールへのサインイン)とDatabase accounts(ウェアハウスへの接続に使用)。このセクションはデータベースアカウントについてです。
    • 最初の接続では、adminユーザーを使用してください。Settingsページからパスワードを初期化またはリセットできます。

Azure上で

  1. 対象ウェアハウスで、Connection → Private Linkを開き、Access VeloDB from Your VPCの下のNew Connectionをクリックします。

  2. Set up one or more endpointsをクリックして、Azure PrivateLinkを開きます。

    azure private link access velodb 2

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

    azure private link access velodb 3

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

    azure private link access velodb 4

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

    azure private link access velodb 5

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

    azure private link access velodb 6

    azure private link access velodb 7

    azure private link access velodb 8

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

    azure private link access velodb 9 1

    azure private link access velodb 9 2

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

    azure private link access velodb 10

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

    azure private link access velodb 11

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

    azure private link access velodb 12

VeloDBがVPCにアクセス

VeloDB Accesses Your VPC

この方向は、VeloDBがVPC内のリソース(例えば、インポート用のデータソース)から読み取る必要がある場合に使用します。

Note VeloDBのプライベートネットワークアクセスによって発生するエンドポイントインスタンスとトラフィック料金は、現在ユーザーに請求されていません。

AWS上で

  1. 対象ウェアハウスで、Connection → Private Linkを開き、Grant VeloDB Access to Your VPCの下のNew Connectionをクリックします。

  2. ページにはウェアハウスのCurrent RegionARN of VeloDBが表示されます。Set up endpoint servicesをクリックして、AWS PrivateLinkコンソールを開きます。

    private link create connection choose endpoint service register

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

    private link create endpoint service on aws

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

    private link create connection choose endpoint service create

    private link create connection choose endpoint service create 1

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

    private link create connection create nlb 0

    private link create connection create nlb 1

    private link create connection create nlb 2

    private link create connection create nlb 3

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

    private link create connection create tg 0

    private link create connection create tg 1

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

    private link create connection choose endpoint service details

    private link create connection choose endpoint service allow principals

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

    private link create connection choose endpoint service details02

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

    private link create connection choose endpoint service chosen

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

    private link velodb acdess user vpc endpoint accept

    private link velodb acdess user vpc endpoint accept ok

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

    private link velodb acdess user vpc endpoint pendingacceptance

Azure上で

  1. 対象ウェアハウスで、Connection → Private Linkを開き、Grant VeloDB Access to Your VPCの下のSet up Connectionをクリックします。

  2. ページにはCurrent RegionSubscription ID of VeloDBが表示されます。Set up endpoint servicesをクリックして、Azure Private Link Serviceコンソールを開きます。

    azure velodb access vpc 2

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

    azure velodb access vpc 3

    ParameterCategoryDescription
    SubscriptionProject detailsPrivate Link Service用のサブスクリプション。
    Resource groupProject detailsPrivate Link Serviceを配置するリソースグループ。
    NameInstance detailsPrivate Link Serviceインスタンス名。
    RegionInstance detailsウェアハウスリージョンと一致する必要があります。
  4. Outbound settingsで、ロードバランサー、フロントエンドIP、ソースNATネットワーク/サブネットを選択し、Next: Access Securityをクリックします。

    azure velodb access vpc 4

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

    azure velodb access vpc 5

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

    azure velodb access vpc 6

    azure velodb access vpc 7

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

    azure velodb access vpc 8

    azure velodb access vpc 8 2

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

    azure velodb access vpc 9 1

    azure velodb access vpc 9 2

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

    azure velodb access vpc 10 2

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

    azure velodb access vpc 11 1

    azure velodb access vpc 11 2

Public Access Allowlist

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

byoc public access allowlist

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

byoc public access allowlist modal

OptionBehavior
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ポップオーバーを使用してください。