削除

Delete API で条件に一致する行やテーブル全体を削除できます。削除は取り消せません。

削除 https://api.telemetry.sh/delete

ヘッダー

スコープのルール:

• DELETE /delete が必要です write または read-and-write

本体

もし where が省略された場合、Telemetry はリクエストをテーブル全体の削除として扱います。

成功の応答

削除応答は、非同期のクリーンアップ確認応答です。 API が返されます 200 OK 削除リライトまたはテーブル無効化ステップが正常にスケジュールされるとすぐに。

一致する行を削除する

{
  "status": "success",
  "message": "Delete rewrite completed; part cleanup is asynchronous"
}

テーブル全体を削除する

{
  "status": "success",
  "message": "Table disabled; part cleanup is asynchronous"
}

cURLでの使用例

という名前のテーブルから 3 日より古いすべての行を削除するには uber_rides cURL を使用すると、次のコマンドを使用できます。

API_KEY="YOUR_API_KEY"
WHERE_CONDITION="timestamp <= (now() - INTERVAL '3 day')"

curl -X DELETE https://api.telemetry.sh/delete \
  -H "Content-Type: application/json" \
  -H "Authorization: $API_KEY" \
  -d @- <<EOF
{
  "table": "uber_rides",
  "where": "$WHERE_CONDITION"
}
EOF

全体を削除したい場合は、 uber_rides 表では、単純に省略します where フィールド:

API_KEY="YOUR_API_KEY"

curl -X DELETE https://api.telemetry.sh/delete \
  -H "Content-Type: application/json" \
  -H "Authorization: $API_KEY" \
  -d '{
    "table": "uber_rides"
  }'

重要な注意事項

• データの削除: 削除エンドポイントを使用する場合は注意してください。もし where 条件が指定されていない場合は、テーブル全体が削除されます。
• 不可逆性: データを削除すると、復元することはできません。
• 従来のエンドポイント: 可能であれば、テーブル全体のライフサイクル操作にはテーブル API を優先します。 DELETE /delete を使用した行レベルの削除には引き続き便利です。 where 条項。

よくあるエラー

• 400 Bad Request JSON ボディが無効な場合
• 400 Bad Request 正規化後にテーブル名に無効な文字が含まれている場合
• 403 Forbidden API キーのみがある場合 read 範囲
• 401 Unauthorized API キーが見つからないか無効な場合
• 404 Not Found まだスキーマが存在しないテーブルから行を削除しようとした場合
• 500 Internal Server Error Telemetry が削除リクエストの実行に失敗した場合