service account を作成する
アプリケーション、pipeline、job が Lakehouse に接続するために専用の認証情報が必要なときは、service account を作成します。パスワードはポータルが生成し、表示されるのは一度だけです。
前提条件
- role に
service-accounts:manageが含まれていること。portal_adminrole にはこの権限があります。 - チームの secret manager など、パスワードを安全に保管する場所があること。
service account を作成する
- Service Accounts を選択します。
- Create Account を選択します。
- Username を入力します (例:
sa_data_ingest)。ユーザー名は後から変更できません。 - 必要に応じて、どのアプリケーションが使うかわかるように Display Name と Description を入力します。
- Create を選択します。

| フィールド | ルール |
|---|---|
| Username | 必須。2〜63 文字。英小文字、数字、ドット (.)、ハイフン (-)、アンダースコア (_) を使用できます。英小文字または数字で始めます。重複はできません。 |
| Display Name | 任意。255 文字以内。 |
| Description | 任意。255 文字以内。 |
パスワードをコピーする
Create を選択すると Service account '<username>' created successfully. が表示され、Credential Generated ウィンドウが開きます。
- Password の横にある Copy を選択します。ボタンが一時的に
Copied! ✓に変わります。 - パスワードを secret manager またはアプリケーションの設定に貼り付けます。
- I have copied the password を選択します。
- Close を選択します。

チェックボックスを選択するまで Close は使えません。ウィンドウの外をクリックしても閉じません。
警告
パスワードが表示されるのはこのときだけです。コピーせずにウィンドウを閉じた場合は、認証情報をローテーションして新しいパスワードを取得してください。service account の認証情報をローテーションするを参照してください。
新しい service account は Active になり、約 1 分以内に接続できるようになります。policy に追加するまで、データは読み取れません。service account にデータアクセス権を付与するを参照してください。
操作が失敗した場合
| メッセージ | 意味 | 対処 |
|---|---|---|
Username format is invalid. Use only lowercase letters, numbers, hyphens, and underscores. | ユーザー名が上の表のルールに合っていません。 | ユーザー名を修正し、もう一度 Create を選択します。 |
Username already exists or is reserved by a system account. | 別の service account またはシステムの service account がこの名前を使っています。 | 別のユーザー名を選びます。 |
Failed to create service account. Please try again or contact your administrator. | service account は作成されていません。何も保存されていません。 | もう一度 Create を選択します。失敗が続く場合はサポートに問い合わせてください。 |