fileset-cli

Domo FileSets — CLI コマンド

FileSets は、Domo が管理するファイルストレージコンテナです。各ファイルセットには、ディレクトリパスに整理されたファイルが格納され、メタデータ、アクセス制御、オプションの AI 搭載検索機能が備わっています。

前提条件： community-domo-cli config set-profile で一度プロフィールを設定してください。詳しい設定方法については、community-cli-howto スキルを参照してください。その後は、以下のすべてのコマンドを追加のフラグなしで実行できます。

コマンドリファレンス

FileSets（コンテナ）

|---------|-------------| | filesets search | FileSets を一覧表示／検索します。名前で絞り込めます | | filesets get <fileset_id> | FileSet のメタデータを取得します | | filesets create --name <name> | 新しい FileSet コンテナを作成します |

FileSet 内のファイル

コマンド	機能
filesets files-search <fileset_id>	ファイルを一覧表示／検索します。名前、ディレクトリ、ページネーションで絞り込めます
filesets file-get <fileset_id> <file_id>	UUID を指定して、単一ファイルのメタデータを取得します
filesets file-get-by-path <fileset_id> --path <path>	パスを指定して、ファイルのメタデータを取得します
filesets download <fileset_id> <file_id> --output <path>	ファイルのバイトデータをローカルパスにダウンロードします
filesets upload <fileset_id> --file-path <path>	バイナリファイルを FileSet ディレクトリにアップロードします
filesets query <fileset_id> --query <text>	ファイルの内容を AI で意味的に検索します

すべての ID は UUID です。削除操作は意図的に対象外としています。

---

FileSets（コンテナ）

FileSets を検索／一覧表示する

# List all (sorted by most recently updated)
community-domo-cli filesets search

# Filter by name
community-domo-cli filesets search --name "Monthly Reports"

# Paginate
community-domo-cli filesets search --limit 25 --offset 25

レスポンスには FileSet オブジェクトの配列が含まれます：

[
  {
    "id": "abc123-fileset-id",
    "name": "Monthly Reports",
    "description": "Automated PDF outputs",
    "created": "2024-01-15T10:00:00Z",
    "createdBy": 12345
  }
]

FileSet を取得する

community-domo-cli filesets get abc123-fileset-id

FileSet を作成する

community-domo-cli filesets create --name "Q1 Reports" --description "Quarterly output files"

--yes を指定しない場合、確認を求められます。ID を含む新しい FileSet オブジェクトが返されます。

---

FileSet 内のファイル

ファイルを参照／検索する

ダウンロード前にファイル ID を調べる主な方法です：

# List all files in a fileset
community-domo-cli filesets files-search abc123-fileset-id

# Browse a specific directory
community-domo-cli filesets files-search abc123-fileset-id \
  --directory-path /reports/2024

# List only direct children (non-recursive)
community-domo-cli filesets files-search abc123-fileset-id \
  --directory-path /reports --immediate-children

# Filter by filename
community-domo-cli filesets files-search abc123-fileset-id --name ".pdf"

# Paginate using the next token from a previous response
community-domo-cli filesets files-search abc123-fileset-id \
  --next-token <token-from-pageContext.next>

レスポンスの形式：

{
  "files": [
    {
      "id": "xyz789-file-id",
      "path": "/reports/2024/march.pdf",
      "name": "march.pdf",
      "contentType": "application/pdf",
      "size": 204800,
      "created": "2024-03-01T08:00:00Z",
      "createdBy": 12345
    }
  ],
  "pageContext": {
    "next": "pagination-token-or-null",
    "offset": 0,
    "limit": 100,
    "total": 42
  }
}

ファイルのメタデータを取得する

# By UUID
community-domo-cli filesets file-get abc123-fileset-id xyz789-file-id

# By path (useful when you know the directory structure)
community-domo-cli filesets file-get-by-path abc123-fileset-id \
  --path /reports/2024/march.pdf

ファイルをダウンロードする

community-domo-cli filesets download abc123-fileset-id xyz789-file-id \
  --output ./downloads/march.pdf

書き込まずにプレビューする場合：

community-domo-cli --dry-run filesets download abc123-fileset-id xyz789-file-id \
  --output ./march.pdf

ファイルをアップロードする

# Upload to root of fileset
community-domo-cli filesets upload abc123-fileset-id \
  --file-path ./report.xlsx

# Upload to a specific directory
community-domo-cli filesets upload abc123-fileset-id \
  --file-path ./report.xlsx \
  --directory-path /reports/2024

使い慣れていない FileSet では、必ず最初にドライランを実行してください：

community-domo-cli --dry-run filesets upload abc123-fileset-id \
  --file-path ./report.xlsx \
  --directory-path /reports/2024

ドライランでは、アップロードせずにファイル名、バイトサイズ、アップロード先のディレクトリが表示されます。実際に実行する場合は、--yes を指定しないと確認を求められます。

AI クエリ（意味検索）

FileSet で aiEnabled: true が設定されている必要があります。ファイルの内容を対象に、自然言語の質問を実行します：

community-domo-cli filesets query abc123-fileset-id \
  --query "What were the key revenue drivers last quarter?"

# Restrict to a directory and return more matches
community-domo-cli filesets query abc123-fileset-id \
  --query "Any mentions of churn risk?" \
  --directory-path /reports/2024 \
  --top-k 10

レスポンス：

{
  "matches": [
    {
      "id": "xyz789-file-id",
      "node": { "id": "...", "name": "q4-analysis.pdf", "path": "/reports/2024/q4-analysis.pdf" },
      "score": 0.89
    }
  ]
}

---

一般的なワークフロー：ファイルを見つけてダウンロードする

# 1. Find the right fileset
community-domo-cli filesets search --name "Monthly Reports"

# 2. Browse its files
community-domo-cli filesets files-search abc123-fileset-id --directory-path /reports/2024

# 3. Download the file you want
community-domo-cli filesets download abc123-fileset-id xyz789-file-id \
  --output ./march.pdf

---

出力形式

すべてのコマンドで --output-format を使用できます（デフォルト：json）：

community-domo-cli --output-format yaml filesets search
community-domo-cli --output-format table filesets files-search abc123-fileset-id

---

FileSets を使用するアプリの構築

Domo カスタムアプリ内で FileSets を操作する方法（ブラウザーからのアップロード／ダウンロード、AI クエリなど）については、fileset-api スキルを参照してください。