API 冪等性の説明: 冪等性キーと安全な再試行、テスト済み

  1. ホーム
  2. ブログ
  3. ソフトウェア開発

ソフトウェア開発

API 冪等性の説明: 冪等性キーと安全な再試行、テスト済み

API 冪等性とは、同じリクエストを 2 回送信すると 1 回送信した場合と同じ効果があることを意味します。二重請求を単一請求に変える Python デモを使用して、どの HTTP メソッドが冪等であるか、POST に冪等キーが必要な理由、安全にキーを構築する方法を学びます。

読了目安9分
API べき等性の説明: べき等性キーと安全な再試行

ポイント

  • API 冪等性 とは、リクエストを繰り返しても副作用が繰り返されないことを意味します。 GET、PUT、DELETE は定義上冪等です。 POSTはそうではありません。
  • 私たちのデモでは、応答が失われて再試行すると、キーなしで 2 件のチャージ が発生し、Idempotency-Key の場合は 1 件 のチャージが発生しました。
  • リクエスト本文のフィンガープリントをキーとともに保存します。サーバーで 422 が返された別の本文を持つキーを再利用します。
  • キーをアトミックに要求します。 2 回の同時再試行では 201 と 409 が取得され、チャージは 1 回だけ行われました。

ネットワーク障害は、サーバーが作業を完了した後、クライアントから応答が返される前に、考えられる最悪の場所で発生します。クライアントはタイムアウトを認識し、再試行し、顧客に 2 回請求されたり、注文が 2 回発送されたりします。 API 冪等性 は、これらの再試行を安全にする設計ルールであり、冪等性キーは、物を作成するリクエストにそれを適用する標準的な方法です。

問題を説明するのではなく示すために、Python 3.13 の組み込み HTTP サーバーと、接続が切断された後に再試行するクライアントを使用して、小規模な支払い API を作成しました。すべてがローカルで実行され、以下の出力はその実行からコピーされたものです。実際の決済プロバイダーはさらに多くの機能を追加するため、コードを教育モデルとして扱ってください。一般的な API 設計については、REST API のベスト プラクティスをご覧ください。

べき等性とは何ですか?

操作を 1 回または複数回実行してもシステムが同じ状態になる場合、その操作は 冪等 です。ライトのスイッチを「オフ」に設定すると冪等です。「オフ」を 5 回押してもオフのままです。スイッチを押すたびに結果が変わるため、スイッチを切り替えることはできません。

冪等性は応答ではなく、サーバーへの影響に関するものであることに注意してください。注文を 2 回削除すると、2 回目の呼び出しで 404 が返されたとしても、注文はいずれの場合も失われているため、冪等です。関連する単語 safe は、GET のように、リクエストがまったく変更しないことを意味します。

どの HTTP メソッドがべき等ですか?

HTTP 仕様 RFC 9110 では、メソッドごとに次のプロパティが定義されています。

方法 安全 べき等 一般的な使用方法
取得、先頭、オプション はい はい 読み取りデータ
置く いいえ はい 既知の URL にあるリソースを置き換える
削除 いいえ はい リソースを削除する
投稿 いいえ いいえ リソースを作成するかアクションをトリガーする
パッチ いいえ 保証されていません 部分更新

この表は、サーバーがすべきことを説明しています。カウンタをインクリメントする不適切な設計の PUT は約束を破ります。そして、PATCH はペイロードに依存します。「数量を 3 に設定する」は冪等ですが、「数量に 1 を加える」は冪等ではありません。 HTTP ステータス コード チートシート には、各メソッドが通常返す応答がリストされています。

再試行の問題

クライアントは POST /payments を送信します。次の 3 つのことが起こります。

  1. リクエストがサーバーに到達することはありません。再試行しても安全です。
  2. サーバーがそれを処理し、応答が到着します。再試行する必要はありません。
  3. サーバーはそれを処理しますが、応答はタイムアウトまたは接続の切断により失われます。クライアントはこれをケース 1 と区別できません。

ケース 3 は危険です。クライアントが再試行すると、サーバーは 2 番目の支払いを作成します。再試行しない場合、ケース 1 で失敗した支払いは行われません。サーバーの助けがなければ、クライアントには安全な選択肢がありません。

冪等性キーの仕組み

この修正は、各論理操作に、サーバーが記憶する一意の ID を与えることです。

  1. クライアントはランダムなキー (通常は UUID) を生成し、それを Idempotency-Key などのヘッダーに含めて送信します。
  2. サーバーはキーを認識したかどうかを確認します。そうでない場合は、キーを記録し、処理を実行し、キーとともに応答を保存します。
  3. 同じキーが再度到着すると、サーバーは作業をスキップし、保存されている応答を返します。
  4. キーは、プロバイダーによって異なりますが、通常は約 24 時間の保持期間を過ぎると期限切れになります。

決済プロバイダーはこのパターンを普及させ、IETF 標準草案では HTTP API 全般の Idempotency-Key ヘッダーについて説明しています。

弊社のデモサーバー

サーバーの中心となるのは、キーを要求する数行であり、その後、作業を実行するか、保存された結果を再生します。

key = self.headers.get("Idempotency-Key")
fp = hashlib.sha256(body).hexdigest()          # fingerprint of the request
if key:
    with lock:                                  # atomic claim
        rec = keys.get(key)
        if rec is None:
            keys[key] = {"fp": fp, "state": "processing"}
    if rec:
        if rec["fp"] != fp:
            return self.reply(422, {"error": "key reused with different body"})
        if rec["state"] == "processing":
            return self.reply(409, {"error": "request in progress"})
        return self.reply(rec["status"], rec["body"], replay=True)

charges.append(data["amount"])                  # the side effect
out = {"charge_id": f"ch_{len(charges)}", "amount": data["amount"]}
if key:
    keys[key].update(state="done", status=201, body=out)

ケース 3 をシミュレートするには、サーバーに充電を完了し、応答せずに接続を閉じるように指示できます。クライアントはエラーを認識し、同じリクエストを再試行します。

結果: キーありとキーなし

no key, attempt 1: ('ERR', 'RemoteDisconnected', None)
no key, retry:     (201, {'charge_id': 'ch_2', 'amount': 500}, None)
charges without key: [500, 500]

key, attempt 1:    ('ERR', 'RemoteDisconnected', None)
key, retry:        (201, {'charge_id': 'ch_1', 'amount': 500}, 'true')
charges with key:  [500]

キーがなかったので、顧客は 500 を 2 回請求され、顧客は請求されたのを一度だけ確認しました。ch_2;最初の充電は見えなくなりました。キーを使用した場合、再試行はオリジナル応答、ch_1、Idempotent-Replayed: trueヘッダーにあり、チャージは 1 つだけ存在します。クライアントは、最初に見逃していた答えを正確に得ました。

ヒント: ステータス コードを含む、保存された応答を再生します。 「重複リクエスト」などの別のメッセージを返すと、すべてのクライアントに特別な処理を記述する必要が生じ、意味がありません。

別のボディでキーを再利用する

キーは 1 つの操作を識別する必要があります。クライアントが誤って異なる金額で同じキーを送信した場合、古い応答を再実行することは誤りであり、新しい金額を請求することも誤りとなります。私たちのサーバーは、本体の SHA-256 フィンガープリントとキーを保存し、それを比較します。

same key same body:      201 (replayed)
same key different body: (422, {'error': 'key reused with different body'})

大声で拒否すると、サイレントクライアントのバグが明らかなバグに変わります。正確なステータス コードはプロバイダーによって異なります。 IETF 草案では、このケースに対して 422 を提案しています。

同時再試行数

攻撃的なクライアントは、最初の試行が完了する前に再試行することがあります。サーバーがキーをチェックし、それを 2 つの別々のステップで挿入する場合、両方のリクエストがチェックに合格し、両方とも課金できます。同じキーを使用して 2 つの同一のリクエストを同時に送信しましたが、その作業には 0.5 秒かかりました。

concurrent same key: [201, 409] charges: [700]

1 つの要求は原子の主張を勝ち取り、請求されました。もう 1 つは、キーが processing 状態にあることを確認し、409 Conflict を取得しました。これは、クライアントに待機して再試行するように指示します。運用環境では、ロックはデータベースの一意の制約または Redis SET NX などのアトミックな「存在しない場合に挿入」操作によって置き換えられるため、多くのサーバーにわたって機能します。

サーバー設計チェックリスト

  • スコープ キーをアカウントまたは API キーに設定するため、2 人の顧客が衝突することはありません。
  • 作業前に請求するをアトミックに記録します。processing状態。
  • 作業が終了したら、完全な応答、ステータスと本文を保存します。
  • リクエストをフィンガープリントし、不一致の再利用を拒否します。
  • 失敗は慎重に処理してください。 サーバー エラーが原因で作業が失敗した場合は、再試行できるようにキーを放します。検証に失敗した場合は、エラーを保存して再生します。
  • 文書化されたウィンドウの後にキーを期限切れにし、可能な場合は副作用とキーの記録を同じトランザクションに保持します。
  • 内部ステップも冪等にします。 メッセージ コンシューマーと Webhook ハンドラーは重複を受信するため、イベント ID で重複を排除します。

クライアント側のルール

  • HTTP 試行ごとではなく、論理操作ごとに 1 つのキーを生成し、その操作の再試行ごとにそれを再利用します。
  • ネットワーク エラー、タイムアウト、409、429、および 5xx 応答、指数バックオフとジッターが発生した場合にのみ再試行します。バックオフについては、API レート制限ガイドで説明しています。
  • 4xx 検証エラーを変更せずに再試行しないでください。同じように失敗します。
  • 保留中の操作でキーを保持すると、再起動されたアプリが安全に再試行できます。

べき等性をテストする方法

冪等性のバグは運用環境のトラフィックが混乱するまで隠れているため、意図的にテストしてください。同じリクエストを 2 回送信し、1 つのリソースが存在することをアサートします。同じキーを異なる本文で送信し、エラーをアサートします。同時テストで行ったように、1 つのキーで並列リクエストを起動し、1 つの副作用をアサートします。サーバーがコミットした後、プロキシまたはテストフックを使用して接続を強制終了し、再試行で元の応答が得られることを確認します。これらのチェックは、Postman を使用した API テスト ガイドのツールを使用して構築された API テストに自然に適合します。

まとめ

API 冪等性により、再試行がリスクからルーチンに変わります。適切な場合には自然な冪等メソッドを使用し、お金を移動したり重要なレコードを作成したりするすべての POST に冪等キーを与えます。サーバー上で、キーをアトミックに要求し、完全な応答を保存して再生し、別の本体での再利用を拒否します。私たちの小さなデモでは、違いが 1 行で示されました。2 つのチャージが 1 つになったのです。

よくある質問

API における冪等性とは何ですか?

同じリクエストを複数回実行するとサーバーに対して 1 回のリクエストと同じ効果が生じる場合、API 操作は冪等であるため、クライアントは安全に再試行できます。

POSTはべき等ですか?

いいえ。通常、POST は毎回新しいリソースを作成するか、アクションをトリガーします。冪等性キーを追加すると、サーバーは繰り返しの試行を認識し、安全に無視できるようになります。

冪等キーとは何ですか?

これは、クライアントがリクエストとともに送信する一意の値であり、多くの場合は UUID です。サーバーはそのキーの下に結果を保存し、そのキーが再度見つかった場合は同じ結果を返します。

冪等性キーはどのくらいの期間保存する必要がありますか?

現実的なすべての再試行をカバーするのに十分な長さ。 24 時間程度が一般的ですが、プロバイダーによって異なるため、期限を文書化し、古いキーを期限切れにします。

重複したリクエストに対してサーバーは何を返すべきでしょうか?

保存されている元の応答を同じステータス コードと本文で返します。オリジナルがまだ実行中の場合は、クライアントが後で再試行できるように 409 を返します。

学び続ける

Stack Quoraと連携する

テスト、WordPress、または SEO についてサポートが必要ですか?

私たちは、チームがより優れたソフトウェアを出荷し、サイトを成長させるのを支援します。あなたが取り組んでいることを教えてください。明確な次のステップを提案します。

読み続けてください

詳しいガイドはこちら テスト、AI、最新の開発

この記事は気に入りましたか?トピックを選択して、最新のチュートリアルに直接アクセスしてください。

人工知能

RAG チャンキング戦略の説明: 固定、オーバーラップ、センテンス、再帰および見出し、測定

tiktoken 0.14 を使用した 1 つのドキュメントでの RAG チャンク戦略の比較: 固定サイズ、オーバーラップ、センテンス パッキング、再帰的分割、見出しベースのチャンク、分割ファクト、孤立見出し、ストレージ コストの測定。

記事を読む →
ソフトウェア開発

API 冪等性の説明: 冪等性キーと安全な再試行、テスト済み

API 冪等性は、私たちが実行した Python サーバーとクライアントで説明されました。応答が失われたため、キーなしでは二重請求、キーありでは単一請求が発生し、さらにキーの再利用、同時再試行、ストレージ ルールが発生しました。

記事を読む →
DevOps

Git Stash の説明: 保存、適用、ポップ、および追跡されていないファイルのテスト済み

Git stash について、Git 2.56 で実行したコマンドを使用して説明しました。メッセージ付きのプッシュ、追跡されていないファイル、リストと表示、適用とポップ、インデックスの保持、競合、スタッシュ ブランチ、ドロップとクリアです。

記事を読む →
ソフトウェアテスト

ペアごとのテストの説明: オールペアによって 216 個のテストが 13 個に削減される方法 (テスト済み)

ペアワイズ テストについては、Python 3.13 で実行したジェネレーターで説明しました。13 のテストでカバーされる 216 の組み合わせのチェックアウト、検証済みのカバレッジ、より大きな例、およびペアワイズで見逃される可能性がある 3 方向のバグです。

記事を読む →
テスト自動化

テストダブルの説明: ダミー、スタブ、スパイ、モック、フェイク、テスト済みの Python コード

テスト ダブルについて、pytest 9.2 で実行される Python の例 (ダミー、スタブ、スパイ、モック、フェイク)、それぞれをいつ使用するか、状態と動作のチェック、およびプレーン モックが隠したバグを autospec がどのようにキャッチするかを説明します。

記事を読む →
データベースとSQL

SQL COALESCE の説明: デフォルト、NULLIF、IFNULL と ISNULL およびトラップ、テスト済み

SQL COALESCE では、SQLite 3.50 で実行したクエリ、つまり最初の非 null 値、空の文字列、数学における NULL、ゼロ除算の NULLIF、集計、LEFT JOIN ギャップ、IFNULL と ISNULL について説明しました。

記事を読む →
データベースとSQL

SQL 自己結合の説明: 従業員とマネージャー、ペアと行の比較、テスト済み

SQL 自己結合については、SQLite 3.50 で実行したクエリで説明しました。従業員とマネージャー、マネージャー以上の収入、一意のペア、日々の変化、2 ホップ チェーン、インデックス作成です。

記事を読む →
ソフトウェア開発

JavaScript スプレッド演算子の説明: スプレッドと残り、コピーと落とし穴、テスト済み

JavaScript スプレッド演算子については、ノード 24 で実行したコード (配列、オブジェクト、浅いコピー、残りのパラメーター、Math.max 制限、reduce のパフォーマンス トラップ) で説明しました。

記事を読む →
ソフトウェア開発

Python コレクション モジュールの説明: Counter、defaultdict、deque など、テスト済み

Python コレクションは、Python 3.13 で実行したコード (Counter、defaultdict、deque、namedtuple、OrderedDict、ChainMap) を使用して説明されています。さらに、list と deque のタイミングとチートシートも含まれています。

記事を読む →
人工知能

LLM コンテキスト ウィンドウの説明: トークン、制限、およびさらに適合させる方法、測定

LLM コンテキスト ウィンドウは、tiktoken を使用して測定したトークン数で説明されています。散文、コード、ヒンディー語の単語とトークン、入出力の予算、チャット履歴のトリミング、RAG のチャンク化とコストです。

記事を読む →
ソフトウェア開発

Webhook の説明: Webhook の仕組みと安全に受信する方法

Webhook について、Python で実行した受信側と送信側で説明しました。プッシュとポーリング、HMAC-SHA256 署名、改ざんおよび再実行されたリクエストの拒否、バックオフによる再試行、冪等性、およびテストのヒントです。

記事を読む →
DevOps

Git Cherry-Pick の説明: 必要なコミットを安全にコピーし、テスト済み

Git チェリーピックでは、Git 2.56 で実行したコマンド、つまりリリース ブランチへのホットフィックスのコピー、新しいハッシュとパッチ ID、-x、-n、コミット範囲、競合、–abort、–skip、およびその後のマージについて説明しました。

記事を読む →
テスト自動化

スナップショット テストの説明: 仕組み、役立つ場合と問題となる場合

スナップショットのテストについては、私たちが実行した pytest と syrupy のデモで説明しました。スナップショットの作成、コード変更後の diff の読み取り、タイムスタンプのマスク、安全な更新、スナップショットが役立つ場合と有害な場合について説明しました。

記事を読む →
ソフトウェアテスト

突然変異テストの説明: 100% のカバー率でもバグを見逃す理由

ミューテーション テストについては、私たちが構築して実行した小さなミューテーション ツールで説明しました。14 個のミュータント、79% のスコアを獲得した 100% のライン カバレッジのテスト スイート、100% に達した境界テスト、さらにツール、コスト、CI ヒントです。

記事を読む →
人工知能

プロンプト インジェクションの説明: AI アプリがどのように騙されるのか、そしてどのように防御するのか

ビルダー向けに説明されたプロンプト インジェクション: 直接攻撃と間接攻撃、キーワード フィルターが失敗する理由 (テストでは 4 つのうち 1 つがブロックされました)、最小権限、ツール許可リスト、出力チェックなどの多層防御。

記事を読む →
DevOps

DNS レコードの説明: A、AAAA、CNAME、MX、TXT、TTL と実際のルックアップ

DNS レコードは、実行したルックアップで説明されています。解決の仕組み、A と AAAA、CNAME ルール、MX と null MX、SPF と検証のための TXT、NS、TTL とキャッシュ、安全な DNS 変更です。

記事を読む →
DevOps

機能フラグの説明: 安全なリリース、段階的なロールアウト、およびフラグの衛生状態

私たちが実行したロールアウト シミュレーションで説明された機能フラグ: フラグの種類、安定したハッシュを使用したパーセンテージ ロールアウト、キル スイッチ、許可リスト、両方のパスのテスト、フラグの負債とベスト プラクティス。

記事を読む →
テスト自動化

Python Faker を使用したテストデータ生成: 現実的で再現性のある安全なデータ

Python Faker でデータ生成をテストし、実行して測定します。再現可能なデータ、ロケール、一意の値、ドメイン形状のレコード、Faker がミスするエッジ ケースのシード、本番データと速度のマスキング。

記事を読む →
ソフトウェアテスト

シフトレフト テストの説明: チームの作業を遅らせることなくバグを早期に発見する

シフトレフト テストについて説明しました。その意味、初期不良の方が安い理由、要件レビューから CI チェックまでの実践、テスターの役割の変化、シフトライト、メトリクス、展開計画について説明します。

記事を読む →
データベースとSQL

SQL 文字列関数の説明: TRIM、SUBSTR、REPLACE、CONCAT、およびデータ クリーンアップ

SQL 文字列関数を実行したクエリとともに説明しました。連結と NULL、TRIM、UPPER と LOWER、SUBSTR と INSTR、REPLACE、パディング、Unicode 長さ、乱雑なデータのクリーニング、方言の違いなどです。

記事を読む →
データベースとSQL

SQL トリガーの説明: BEFORE トリガーと AFTER トリガー、監査ログ、および落とし穴

SQL トリガーについて、実行したトリガーを使用して説明します: BEFORE と AFTER、OLD と NEW、監査ログ、検証、ストック更新、WHEN 条件、ロールバック、方言の違い、およびそれらを回避するタイミング。

記事を読む →
ソフトウェア開発

Python JSON モジュールの説明: ダンプ、ロード、カスタム タイプ、および一般的なエラー

Python JSON モジュールでは、ダンプとロード、ファイル、型変換、日付と小数点、カスタム エンコーダー、object_hook、float 精度、解析エラー、JSON 行など、実行したコードを使用して説明しました。

記事を読む →
ソフトウェア開発

ES モジュールと CommonJS: Node.js での JavaScript インポートの動作 (テスト済み)

ES モジュールと CommonJS について、Node.js で実行したコード (インポートおよびエクスポート構文、require、ライブ バインディング、キャッシュ、トップレベルの待機、動的インポート、ファイル拡張子、相互運用) を使用して説明しました。

記事を読む →
ソフトウェア開発

Python 正規表現の説明: パターン、グループ、先読みと落とし穴、テスト済み

Python 正規表現は、検索と一致、findall、グループと名前付きグループ、貪欲と遅延、サブ、先読み、フラグ、Unicode のサプライズ、壊滅的なバックトラッキングなど、実行したパターンで説明しました。

記事を読む →
人工知能

LLM 構造化出力の説明: AI モデルから信頼性の高い JSON を取得する

LLM 構造化出力は、Pydantic で実行した検証とともに説明されています。JSON モードとスキーマ、制約付きデコード、モデル出力が中断される方法、再試行ループ、セマンティック チェックです。

記事を読む →
DevOps

SSH キーの説明: 仕組み、ssh-keygen、Ed25519、および安全な習慣

SSH キーについて、私たちが生成したキーとともに説明しました: 公開キーと秘密キー、ssh-keygen、Ed25519 と RSA、指紋、パスフレーズ、ssh-agent、authorized_keys、構成ファイル、GitHub、およびキーの衛生状態。

記事を読む →
DevOps

HTTP キャッシュの説明: ライブ テストによるキャッシュ制御、ETag、および 304 レスポンス

HTTP キャッシュについて、私たちが実行した小規模サーバーで説明しました。キャッシュ制御ディレクティブ、最大有効期間、キャッシュなしとストアなし、ETag の再検証と 304 応答、CDN、キャッシュ無効化とヘッダーのテストです。

記事を読む →
テスト自動化

API コントラクトのテストの説明: 重大な変更を出荷前に把握する

API contract testing explained with a schema check we ran: what a contract is, consumer-driven contracts, Pact, OpenAPI, which changes break consume…

記事を読む →
ソフトウェアテスト

リスクベースのテストの説明: リスクをスコアリングし、マトリックスを構築し、重要なものをテストする

リスクベースのテストについて段階的に説明します。リスクの特定、可能性と影響のスコアリング、リスク マトリックスの構築、テストの深さへのリスクのマッピング、実際の例とよくある間違いです。

記事を読む →
データベースとSQL

SQL 制約の説明: NOT NULL、UNIQUE、CHECK、および FOREIGN KEY、テスト済み

SQL 制約について、実行したテストで説明しました。NOT NULL、UNIQUE、CHECK、DEFAULT、PRIMARY、FOREIGN KEY、NULL の抜け穴、SQLite の外部キー設定、名前付け制約とそれらのテストです。

記事を読む →
データベースとSQL

SQL 日付関数の説明: バグのない日付の追加、比較、グループ化

SQL の日付関数を、実行したクエリで説明しました。間隔の追加、月末のサプライズ、日付の違い、BETWEEN トラップ、日別のグループ化、タイム ゾーン、インデックス、方言の違いなどです。

記事を読む →
ソフトウェア開発

Python asyncio の説明: リアル タイミングでの async、await、gather、および TaskGroup

Python asyncio は、コルーチン、await、gather、TaskGroup、エラー処理、タイムアウト、同時実行の制限、パフォーマンスを損なうブロッキングコールの間違いなど、時間を測定したコードで説明しました。

記事を読む →
ソフトウェア開発

JavaScript におけるデバウンスとスロットル: それぞれの仕組み、いつ使用するか、テスト済み

JavaScript でのデバウンスとスロットルについて、Node.js で測定したタイミングを使用して説明します。それぞれの仕組み、単純な実装、先頭と末尾の呼び出し、実際の使用例とテストです。

記事を読む →
ソフトウェア開発

Python コンテキスト マネージャーの説明: with ステートメント、contextlib、および実際の使用法

Python コンテキスト マネージャーは、実行したコードを使用して説明しました。仕組み、__enter__ と __exit__、contextlib.contextmanager、suppress、ExitStack、データベース トランザクション、およびよくある間違いについて説明しました。

記事を読む →
人工知能

LLM 温度と Top-p の説明: AI モデルが次の単語を選択する方法

LLM 温度と top-p は、私たちが実行したシミュレーションで説明しました。確率がどのように再形成されるか、top-p が保持するもの、タスク別の推奨設定、決定論、AI 機能のテストです。

記事を読む →
DevOps

YAML の説明: 構文、ノルウェー問題、テストしたその他の罠

YAML は、基本構文、リストとマップ、ノルウェー問題、浮動小数点数に変換されるバージョン、8 進郵便番号、60 進数、アンカー、複数行テキスト、安全な読み込みなどのパーサー テストで説明されています。

記事を読む →
DevOps

Cron ジョブの説明: 構文、実際のスケジュール、およびそれらを壊す間違い

Cron ジョブは、検証したスケジュールとともに説明されています。5 つのフィールド、演算子、実際の例、月日または曜日のトラップ、環境の問題、ロギング、重複、タイム ゾーンです。

記事を読む →
人工知能

AI 幻覚の説明: 言語モデルが物事をでっち上げる理由とそれを軽減する方法

AI 幻覚について説明しました。幻覚とは何か、言語モデルが幻覚を生成する理由、一般的な種類、グラウンディングとプロンプトで幻覚を軽減する方法、そして私たちが実行した簡単なチェックです。

記事を読む →
DevOps

環境変数の説明: .env ファイル、シークレット、および設定が正しく行われている

実行した Python の例を使用して環境変数について説明します。環境変数の読み取りと設定、すべての値が文字列である理由、.env ファイル、プロセスの継承、シークレット、検証について説明します。

記事を読む →
ソフトウェア開発

API レート制限の説明: アルゴリズム、ヘッダー、および 429 エラーの処理

API レート制限については、実行したシミュレーションで説明します。トークン バケット、固定ウィンドウ、スライディング ウィンドウ、429 応答、レート制限ヘッダー、バックオフによる再試行、およびテスト制限です。

記事を読む →
テスト自動化

Python でのモッキング:unittest.mock、patch、およびテストを嘘にする間違い

Python でのunittest.mockによるモック、テスト済み: モックとreturn_value、side_effect、名前が使用されている場所のパッチ、仕様と自動仕様、日付のモック、およびよくある間違い。

記事を読む →
ソフトウェアテスト

コードカバレッジの説明: 回線カバレッジとブランチカバレッジ、および 100% の実際の意味

実際のcoverage.pyの実行でコードカバレッジを説明: 行、分岐、条件のカバレッジ、レポートの読み取り、100%のカバレッジでもバグを見逃す可能性がある理由、および賢明なターゲット。

記事を読む →
データベースとSQL

SQL における DELETE、TRUNCATE、DROP: 違い、ロールバック、およびそれぞれをいつ使用するか

DELETE、TRUNCATE、DROP について、テスト済み SQL を使用して説明します。それぞれの削除内容、ロールバック、トリガー、ID リセット、速度、PostgreSQL、MySQL、SQL Server、SQLite の違いについて説明します。

記事を読む →
データベースとSQL

SQL ビューの説明: 作成、使用、落とし穴の回避、例を示します

SQL ビューについて、実行したクエリとともに説明しました。ビューの作成、ライブ結果、列の非表示、パフォーマンス、更新可能なビューと具体化されたビュー、壊れた依存関係、ベスト プラクティスについて説明します。

記事を読む →
ソフトウェア開発

TypeScript インターフェイスと型: 実際の違い、コンパイラでテスト

TypeScript インターフェイスと型、実際のコンパイラでチェック: 両方でできること、片方だけでできること、宣言のマージ、拡張と交差、および従うべき簡単なルール。

記事を読む →
ソフトウェア開発

Python *args と **kwargs の説明: 柔軟な関数と明確な例

Python の *args と **kwargs について、実行したコードで説明しました。パッキングとアンパッキング、パラメーターの順序、キーワードのみの引数と位置のみの引数、デコレーター、一般的なエラーです。

記事を読む →
ソフトウェア開発

Python Lambda 関数: 構文、実際の用途、および使用すべきでない場合

Python のラムダ関数について、実行したコードとともに説明します。構文、キーによるソート、マップとフィルター、クロージャー、遅延バインディング トラップ、通常の def がより適切な選択である場合。

記事を読む →
人工知能

AIエージェントとは何ですか?シンプルなエージェント ループを実行できる仕組み

AIエージェントとは何ですか?エージェント ループ、ツール、メモリ、ガードレール、実行した小さな Python ループ、実際のリスク、およびシンプルなチャットボットがより良い選択である場合についてのわかりやすいガイドです。

記事を読む →
DevOps

モニタリングと可観測性: ログ、メトリクス、トレースによる本当の違い

モニタリングと可観測性について説明: 既知および未知の障害、ログ、メトリクスとトレース、チェックアウト インシデントのウォークスルー、ゴールデン シグナル、OpenTelemetry、および便利なアラート。

記事を読む →
DevOps

Docker ボリュームとバインド マウント: コンテナ データを正しい方法で保持する

Docker ボリュームとバインド マウントについて説明します。コンテナ データが消える理由、名前付きボリューム、バインド マウント、tmpfs、Compose の例、バックアップ、アクセス許可、およびそれぞれをいつ使用するかについて説明します。

記事を読む →
テスト自動化

TDD と BDD: 主な違い、1 つの機能が両方の方法で構築され、それぞれをいつ使用するか

TDD と BDD は、両方の方法で構築された 1 つの割引機能で説明されています。実行したコードによるレッド-グリーン-リファクタリング、Given-When-Then シナリオ、ツール、トレードオフ、およびそれぞれをいつ使用するかです。

記事を読む →
ソフトウェアテスト

ユーザー受け入れテスト (UAT): プロセス、チェックリスト、および実際の例

ユーザー受け入れテストの説明: 誰が実行するか、QA との違い、7 段階のプロセス、UAT テスト ケース テンプレート、チェックリスト、サインオフ基準、およびよくある間違い。

記事を読む →
データベースとSQL

SQL NULL 値の説明: IS NULL、COALESCE、NULLIF、および回避すべきトラップ

SQL の NULL 値について、実行したクエリで説明しました。3 つの値のロジック、IS NULL、COALESCE、NULLIF、集計、結合、並べ替えでの NULL の扱い方、およびそれが密かに引き起こすバグです。

記事を読む →
データベースとSQL

SQL CASE WHEN ステートメント: 構文、実際の例、およびよくある間違い

SQL CASE WHEN では、単純な検索フォーム、条件順序、SUM を使用したピボット、COUNT トリック、カスタム並べ替え、更新、回避すべき NULL トラップなど、実行したクエリを使用して説明しました。

記事を読む →
ソフトウェア開発

JWTとは何ですか? JSON Web トークンを実際の例で説明する

JWTとは何ですか? JSON Web トークンについて説明しました。3 つの部分、実行したコード内で構築および改ざんされたトークン、JWT とセッション、ストレージ、リフレッシュ トークン、およびセキュリティ上の間違いです。

記事を読む →
ソフトウェア開発

JavaScript イベントループの説明: コールスタック、マイクロタスク、タイマーと例

JavaScript イベント ループについて、実行したコードで説明しました。コール スタック、タスク キュー、マイクロタスク キュー、setTimeout 0 が即時ではない理由、ブロッキング、スターベーション、およびインタビュー クイズです。

記事を読む →
ソフトウェア開発

Python ジェネレーターと収量の説明: 実際の例でメモリを節約する

Python ジェネレーターと Yield について、実行したコードを使用して説明します。一時停止と再開の方法、メモリ節約の測定、パイプライン、無限シーケンス、Yield from、send、および一般的なトラップについて説明します。

記事を読む →
人工知能

埋め込みとは何ですか?ベクトルとコサインの類似度を簡単に説明

埋め込みとは何ですか?ベクトル、コサイン類似度、セマンティック検索に関する平易なガイド。私たちが実行した小さな例、一般的な使用法、モデルの選択、既知の制限が含まれています。

記事を読む →
DevOps

Blue-Green デプロイメントと Canary デプロイメント: 違い、トレードオフ、および選択方法

ブルー グリーン デプロイメントとカナリア デプロイメントについて説明: それぞれの仕組み、コスト、リスクとロールバック、テストした安定したユーザー バケット化、データベース移行、ローリング アップデート、および選択方法。

記事を読む →
テスト自動化

不安定なテスト: 問題の原因とそれを永久に修正する方法

不安定なテストについては、私たちが実行したデモを使用して説明しました。主な原因、確認および診断する方法、タイミングの適切な修正、共有された状態と日付、隔離プロセスなどです。

記事を読む →
ソフトウェアテスト

負荷テストとストレス テスト: 違い、メトリクス、および k6 の例

ロード テストとストレス テストについて説明します。それぞれが何を証明するか、スパイク テストとソーク テスト、重要な指標、平均値が誤解を招く理由、K6 の例、テストの計画方法について説明します。

記事を読む →
ソフトウェアテスト

テスト ケースとテスト シナリオ: 主な違い、例、およびそれぞれをいつ使用するか

テスト ケースとテスト シナリオの説明: 明確な定義、並べて表、シナリオからケースへの 1 つのパスワード リセット機能、テンプレート、およびそれぞれをいつ使用するか。

記事を読む →
データベースとSQL

SQL クエリの最適化: 実行プランを読み取り、タイミングを考慮して遅いクエリを修正

SQL クエリの最適化は 100 万行でテストされています。実行プランの読み取り、適切なインデックスの追加、検索対象外のフィルターの修正、複合インデックスとキーセットのページネーションの使用。

記事を読む →
データベースとSQL

SQL UNION と UNION ALL: 違い、例、テストされたパフォーマンス

SQL UNION と UNION ALL について、実行したクエリで説明しました。重複、両方に従うルール、実際のデータのバグ、測定されたパフォーマンス、INTERSECT と EXCEPT、およびそれぞれをいつ使用するかについて説明します。

記事を読む →
ソフトウェア開発

JavaScript Fetch API チュートリアル: GET、POST、エラー処理、タイムアウト

ローカル サーバーに対してテストされた JavaScript Fetch API チュートリアル: GET と POST、404 がスローされない理由、再利用可能なヘルパー、クエリ文字列、タイムアウト、CORS、およびよくある間違い。

記事を読む →
ソフトウェア開発

Python ファイル処理: 読み取り、書き込み、CSV、JSON、パスライブラリと例

Python のファイル処理について、実行したコードで説明します。オープン モード、大きいファイルの読み取り、CSV、JSON、パスライブラリ、バイナリ ファイル、安全な書き込み、エラー処理、およびよくある間違いについて説明します。

記事を読む →
ソフトウェア開発

Python のクラスとオブジェクト: 実際の例を含む OOP チュートリアル

Python のクラスとオブジェクトについて、実行したコードとともに説明します: __init__、メソッド、クラスとインスタンスの属性、継承、プロパティ、ダンダー メソッド、データクラス、およびよくある間違い。

記事を読む →
人工知能

大規模言語モデルとは何ですか? LLM の仕組みを誇大広告なしで説明

大規模言語モデルとは何ですか? LLM は、トークン、エンベディング、アテンション、トレーニング、温度およびコンテキスト ウィンドウ、小さな次の単語のデモ、実際の制限など、平易な言葉で説明されています。

記事を読む →
DevOps

初心者のための Linux コマンド: 例を含む基本ターミナル ガイド

初心者向けの Linux コマンド。ナビゲーション、ファイル、ログの表示、grep、パイプ、権限、プロセス、アーカイブなどのタスク別にグループ化されており、実用的なログ分析の例も含まれています。

記事を読む →
テスト自動化

Selenium と Playwright: 主な違い、コードの比較、どちらを選択するか

Selenium と Playwright の比較: アーキテクチャ、待機、ブラウザと言語のサポート、デバッグ、両方のツールでの同じテスト、移行のアドバイスと選択方法。

記事を読む →
ソフトウェアテスト

等価性分割: テスト設計手法を実際の例で説明

等価性パーティション化について説明しました。有効なパーティションと無効なパーティションを見つける方法、年齢、パスワード、クーポンに関する実際の例、実行したテスト、境界と組み合わせる理由。

記事を読む →
ソフトウェアテスト

ソフトウェアテストにおける重大度と優先度: 相違点、マトリックス、および実際の例

ソフトウェア テストにおける重大度と優先度について説明します。明確な定義、例を含む 4 方向のマトリックス、レベル スケール、それぞれの設定者、バグ トリアージの実行方法。

記事を読む →
データベースとSQL

SQL サブクエリのチュートリアル: 型、相関サブクエリ、および EXISTS と例

実行したクエリを含む SQL サブクエリのチュートリアル: スカラー、IN、FROM、SELECT サブクエリ、相関サブクエリ、EXISTS、NOT IN NULL トラップ、サブクエリ対 JOIN 対 CTE。

記事を読む →
データベースとSQL

SQL トランザクションと ACID の説明: COMMIT、ROLLBACK、分離レベル

SQL トランザクションと ACID について、実行した銀行振込で説明しました。COMMIT、ROLLBACK、セーブポイント、ロック、分離レベル、ダーティ リード、デッドロック、ベスト プラクティスについて説明します。

記事を読む →
ソフトウェア開発

Git コマンドのチートシート: 実際に使用するコマンドと例

実際のデモ リポジトリからの出力を含む、タスク別にグループ化された Git コマンド チート シート (セットアップ、ステージング、ブランチ、リモート、スタッシュ、履歴、間違いの取り消し)。

記事を読む →
ソフトウェア開発

JavaScript Promise の説明: then、catch、Promise.all、およびよくある間違い

JavaScript の Promise を、実行したコードで説明します。ステート、then および catch チェーン、エラー処理、Promise.all、allSettled、race および any、イベント ループ、およびよくある間違いです。

記事を読む →
ソフトウェア開発

Python 辞書チュートリアル: メソッド、例、一般的なパターン

私たちが実行したコードを含む Python 辞書チュートリアル: 辞書の作成、読み取り、更新、主要なメソッド、マージ、内包表記、パターンのカウントとグループ化、およびよくある間違い。

記事を読む →
人工知能

RAGとは何ですか?検索拡張生成を実際の例で説明する

RAGとは何ですか?検索拡張生成について、インデックス作成、チャンク化、埋め込み、検索、実際に動作する小さな Python の例、評価、一般的な失敗など、ステップごとに説明します。

記事を読む →
DevOps

初心者向け Terraform チュートリアル: 最初のファイルからモジュールまでのコードとしてのインフラストラクチャ

初心者向けの Terraform チュートリアル: クラウド アカウントなしで開始し、初期化、計画、適用を学び、次に変数、出力、状態、モジュール、安全なチーム ワークフローを学びます。

記事を読む →
DevOps

Docker と Kubernetes: 主な違い、連携方法、どちらが必要か

Docker と Kubernetes について説明しました。それぞれの機能、同じアプリを両方で実行すること、Docker Compose と Swarm の比較、dockershim の変更、必要なものを決定する方法などです。

記事を読む →
テスト自動化

初心者向けの Pytest チュートリアル: フィクスチャ、パラメータ化、実際の例

pytest 9.2 で実行したテストを含む初心者向けの pytest チュートリアル: アサーション、フィクスチャ、parametrize、conftest、マーカー、tmp_path、monkeypatch、便利なフラグ、CI。

記事を読む →
ソフトウェアテスト

ソフトウェア テスト ライフ サイクル (STLC): 6 つのフェーズ、開始基準と終了基準、例

ソフトウェア テストのライフ サイクルについては、開始基準と終了基準を含む 6 つの STLC フェーズ、成果物、実際に動作するログイン機能の例、STLC と SDLC、およびアジャイルにおける STLC について説明しました。

記事を読む →
ソフトウェア開発

Git mergeとrebaseの違い:例と使い分け

Git mergeとrebaseの違いを、実際のログ出力、比較表、rebaseの黄金律、安全なチームワークフローで解説します。

記事を読む →
ソフトウェア開発

Pythonのリスト内包表記:構文・例・使うべきでない場面

Pythonのリスト内包表記を解説:構文、フィルタ、if-else、ネストしたループ、実測した処理時間、そして通常のforループの方が良い場面。

記事を読む →
データベースとSQL

SQL JOINを例で解説(Inner・Left・Right・Full)

サンプルのテーブルとクエリでSQL JOINを順に解説。INNER、LEFT、RIGHT、FULL、CROSS、SELFに加え、よくある間違いとパフォーマンスのコツも紹介します。

記事を読む →