

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon MWAA に関するよくある質問
<a name="mwaa-faqs"></a>

このページでは、Amazon Managed Workflows for Apache Airflow を使用する際に起こる可能性のある一般的な疑問について説明します。

**Contents**
+ [サポートバージョン](#q-supported-versions)
  + [Amazon MWAA は Apache Airflow v2 に対して何をサポートしていますか?](#airflow-support)
  + [どの Python バージョンを使用できますか?](#python-version)
+ [ユースケース](#t-common-questions)
  + [Amazon MWAA を Amazon SageMaker Unified Studio で使用できますか?](#t-use-sagemaker-unified-studio)
  + [AWS Step Functions と Amazon MWAA とは](#t-step-functions)
+ [環境仕様](#q-supported-features)
  + [各環境で使用できるタスクストレージの容量はどれくらいですか?](#worker-storage)
  + [Amazon MWAA 環境で使用されるデフォルトのオペレーティングシステムは何ですか?](#default-os)
  + [Amazon MWAA 環境にカスタムイメージを使用することはできますか?](#custom-image)
  + [Amazon MWAA HIPAA は準拠していますか?](#hipaa-compliance)
  + [Amazon MWAA はスポットインスタンスをサポートしていますか?](#spot-instances)
  + [Amazon MWAA はカスタムドメインをサポートしていますか?](#custom-dns)
  + [自分の環境に SSH で接続できますか?](#ssh-dag)
  + [VPC セキュリティグループに自己参照ルールが必要なのはなぜですか?](#sg-rule)
  + [IAM の異なるグループの環境を非表示にすることはできますか?](#hide-environments)
  + [一時データを Apache Airflow ワーカーに保存できますか?](#store-data)
  + [25 個以上の Apache Airflow ワーカーを指定できますか?](#scaling-quota)
  + [Amazon MWAA は共有の Amazon VPC をサポートしていますか、それとも共有サブネットをサポートしていますか?](#shared-vpc)
  + [Apache Airflow でタスクの実行とワークフローオーケストレーションを管理するために、カスタム Amazon SQS キューを作成または統合できますか?](#create-sqs)
+ [メトリクス](#q-metrics)
  + [ワーカーをスケールするかどうかの判断にはどのようなメトリクスが使用されますか?](#metrics-workers)
  + [CloudWatch カスタムメトリクスを作成するには](#metrics-custom)
+ [DAG、オペレータ、接続、その他の質問](#q-dags)
  + [`PythonVirtualenvOperator` は使えますか?](#virtual-env-dags)
  + [Amazon MWAA が新しい DAG ファイルを認識するまでどのくらいかかりますか?](#recog-dag)
  + [DAG ファイルが Apache Airflow に取り込まれないのはなぜですか?](#dag-file-error)
  + [環境から `plugins.zip` または `requirements.txt` を削除できますか?](#remove-plugins-reqs)
  + [Apache Airflow v2.0.2 の管理プラグインメニューにプラグインが表示されないのはなぜですか?](#view-plugins-ui)
  + [AWS Database Migration Service (DMS) 演算子を使用できますか?](#ops-dms)
  + [AWS 認証情報を使用して Airflow REST API にアクセスする場合、スロットリング制限を 10 トランザクション/秒 (TPS) 以上に増やすことはできますか?](#increase-throttling-limit)
  + [Amazon MWAA では、Airflow タスク実行 API サーバーはどこで実行されますか?](#task-execution-server)

## サポートバージョン
<a name="q-supported-versions"></a>

### Amazon MWAA は Apache Airflow v2 に対して何をサポートしていますか?
<a name="airflow-support"></a>

Amazon MWAA がサポートしている内容については、[Amazon Managed Workflows for Apache Airflow 上の Apache Airflow のバージョン](airflow-versions.md) を参照してください。

### どの Python バージョンを使用できますか?
<a name="python-version"></a>

以下の Apache Airflow バージョンは、Amazon Managed Workflows for Apache Airflow でサポートされています。

**注記**  
2025 年 12 月 30 日以降、Amazon MWAA は、Apache Airflow バージョン v2.4.3、v2.5.1、および v2.6.3 のサポートを終了します。詳細については、[Apache Airflow のバージョンサポートとよくある質問](airflow-versions.md#airflow-versions-support) を参照してください。
Apache Airflow v2.2.2 以降、Amazon MWAA は Python 要件、プロバイダーパッケージ、カスタムプラグインを Apache Airflow ウェブサーバーに直接インストールすることをサポートしています。
 Apache Airflow v2.7.2 から、要件ファイルには `--constraint` ステートメントを含める必要があります。制約を指定しない場合、要件に記載されているパッケージが使用している Apache Airflow のバージョンと互換性があることを確認するため、Amazon MWAA はお客様に代わって制約を指定します。  
要件ファイルに制約を設定する方法の詳細については、[Python 依存関係のインストール](working-dags-dependencies.md#working-dags-dependencies-syntax-create) を参照してください。


| Apache Airflow のバージョン | Apache Airflow リリース日 | Amazon MWAA 利用開始日 | Apache Airflow の制約 | Python バージョン | 
| --- | --- | --- | --- | --- | 
|  [v2.11.0](https://airflow.apache.org/docs/apache-airflow/2.11.0)  |  [2025 年 5 月 20 日](https://airflow.apache.org/docs/apache-airflow/2.11.0/release_notes.html#airflow-2-11-0-2022-05-20)  |  2026 年 1 月 7 日  |  [v2.11.0 制約ファイル](https://raw.githubusercontent.com/apache/airflow/constraints-2.11.0/constraints-3.12.txt)  |  [Python 3.12](https://peps.python.org/pep-0693/)  | 
|  [v3.0.6](https://airflow.apache.org/docs/apache-airflow/3.0.6)  |  [2025 年 8 月 29 日](https://airflow.apache.org/docs/apache-airflow/3.0.6/release_notes.html#airflow-3-0-6-2025-08-29)  |  2025 年 10 月 1 日  |  [v3.0.6 制約ファイル](https://raw.githubusercontent.com/apache/airflow/constraints-3.0.6/constraints-3.12.txt)  |  [Python 3.12](https://peps.python.org/pep-0693/)  | 
|  [v2.10.3](https://airflow.apache.org/docs/apache-airflow/2.10.3)  |  [2024 年 11 月 4 日](https://airflow.apache.org/docs/apache-airflow/2.10.3/release_notes.html#airflow-2-10-3-2024-11-04)  |  2024 年 12 月 18 日  |  [v2.10.3 制約ファイル](https://raw.githubusercontent.com/apache/airflow/constraints-2.10.3/constraints-3.11.txt)  |  [Python 3.11](https://peps.python.org/pep-0664/)  | 
|  [v2.10.1](https://airflow.apache.org/docs/apache-airflow/2.10.1)  |  [2024 年 9 月 5 日](https://airflow.apache.org/docs/apache-airflow/2.10.1/release_notes.html#airflow-2-10-1-2024-09-05)  |  2024 年 9 月 26 日  |  [v2.10.1 制約ファイル](https://raw.githubusercontent.com/apache/airflow/constraints-2.10.1/constraints-3.11.txt)  |  [Python 3.11](https://peps.python.org/pep-0664/)  | 
|  [v2.9.2](https://airflow.apache.org/docs/apache-airflow/2.9.2)  |  [2024 年 6 月 10 日](https://airflow.apache.org/docs/apache-airflow/2.10.1/release_notes.html#airflow-2-9-2-2024-06-10)  |  2024 年 7 月 9 日  |  [v2.9.2 制約ファイル](https://raw.githubusercontent.com/apache/airflow/constraints-2.9.2/constraints-3.11.txt)  |  [Python 3.11](https://peps.python.org/pep-0664/)  | 
|  [v2.8.1](https://airflow.apache.org/docs/apache-airflow/2.8.1)  |  [2024 年 1 月 19 日](https://airflow.apache.org/docs/apache-airflow/2.10.1/release_notes.html#airflow-2-8-1-2024-01-19)  |  2024 年 2 月 23 日  |  [v2.8.1 制約ファイル](https://raw.githubusercontent.com/apache/airflow/constraints-2.8.1/constraints-3.11.txt)  |  [Python 3.11](https://peps.python.org/pep-0664/)  | 
|  [v2.7.2](https://airflow.apache.org/docs/apache-airflow/2.7.2)  |  [2023 年 10 月 12 日](https://airflow.apache.org/docs/apache-airflow/2.10.1/release_notes.html#airflow-2-7-2-2023-10-12)  |  2023 年 11 月 6 日  |  [v2.7.2 制約ファイル](https://raw.githubusercontent.com/apache/airflow/constraints-2.7.2/constraints-3.11.txt)  |  [Python 3.11](https://peps.python.org/pep-0664/)  | 

自己管理型の Apache Airflow デプロイの移行、または既存の Amazon MWAA 環境の移行について、メタデータデータベースのバックアップ手順を含む詳細情報は、[Amazon MWAA 移行ガイド](https://docs.aws.amazon.com/mwaa/latest/migrationguide/index.html) を参照してください。

## ユースケース
<a name="t-common-questions"></a>

### Amazon MWAA を Amazon SageMaker Unified Studio で使用できますか?
<a name="t-use-sagemaker-unified-studio"></a>

はい。Amazon SageMaker Unified Studio ワークフローを使用すると、Amazon SageMaker Unified Studio で一連のタスクをセットアップして実行することができます。Amazon SageMaker Unified Studio ワークフローは Apache Airflow を使用してデータ処理手順をモデル化し、Amazon SageMaker Unified Studio のコードアーティファクトをオーケストレーションします。詳細については、[ワークフロー](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/workflow-orchestration.html) セクションを参照してください。Amazon SageMaker の詳細については、[Amazon SageMakerとは](https://docs.aws.amazon.com/next-generation-sagemaker/latest/userguide/what-is-sagemaker.html) を参照してください。

### AWS Step Functions と Amazon MWAA とは
<a name="t-step-functions"></a>

1. Step Functions は 1 件の注文または 100 万件の注文の需要に合わせてスケーリングできるため、Step Functions を使用して個々の顧客の注文を処理できます。

1. 前日の注文を処理する夜間ワークフローを実行している場合は、Step Functions または Amazon MWAA を使用できます。Amazon MWAA には、使用している AWS リソースからワークフローを抽象化するオープンソースオプションが用意されています。

## 環境仕様
<a name="q-supported-features"></a>

### 各環境で使用できるタスクストレージの容量はどれくらいですか?
<a name="worker-storage"></a>

タスクストレージは 20 GB に制限されており、[Amazon ECS Fargate 1.4](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/fargate-task-storage.html#fargate-task-storage-linux-pv) によって指定されています。RAM の容量は指定した環境クラスによって決まります。環境タグ付けの詳細については、[Amazon MWAA 環境クラスの構成](environment-class.md) を参照してください。

### Amazon MWAA 環境で使用されるデフォルトのオペレーティングシステムは何ですか?
<a name="default-os"></a>

Amazon MWAA 環境は、バージョン 2.6 以前では Amazon Linux 2 を実行しているインスタンスに、バージョン 2.7 以降では Amazon Linux 2023 を実行しているインスタンスに作成されます。

### Amazon MWAA 環境にカスタムイメージを使用することはできますか?
<a name="custom-image"></a>

カスタムイメージはサポートされていません。Amazon MWAA は Amazon Linux AMI 上に構築されたイメージを使用します。Amazon MWAA は、環境の Amazon S3 バケットに追加した requirements.txt ファイルに指定されている要件に合わせて`pip3 -r install` を実行することにより、追加の要件をインストールします。

### Amazon MWAA HIPAA は準拠していますか?
<a name="hipaa-compliance"></a>

Amazon は [Health Insurance Portability and Accountability Act (HIPAA)](https://aws.amazon.com/compliance/hipaa-compliance/) に対応しています。HIPAA Business Associate Addendum (BAA) を と締結している場合は AWS、2022 年 11 月 14 日以降に作成された環境の保護医療情報 (PHI) を処理するワークフローに Amazon MWAA を使用できます。

### Amazon MWAA はスポットインスタンスをサポートしていますか?
<a name="spot-instances"></a>

Amazon MWAA は現在、Apache Airflow 用のオンデマンド Amazon EC2 スポットインスタンスタイプをサポートしていません。ただし、Amazon MWAA 環境では、例えば Amazon EMR や Amazon EC2 でスポットインスタンスをトリガーできます。

### Amazon MWAA はカスタムドメインをサポートしていますか?
<a name="custom-dns"></a>

Amazon MWAA ホスト名にカスタムドメインを使用できるようにするには、次のいずれかを実行します。
+ パブリックウェブサーバーにアクセスできる Amazon MWAA デプロイでは、Amazon CloudFront と Lambda @Edge を使用してトラフィックを環境に誘導し、カスタムドメイン名を CloudFront にマッピングできます。パブリック環境用のカスタムドメインの設定の詳細と例については、Amazon MWAA examples GitHub リポジトリにある [パブリックウェブサーバー用 Amazon MWAA カスタムドメイン](https://github.com/aws-samples/amazon-mwaa-examples/tree/main/usecases/mwaa-public-webserver-custom-domain) のサンプルを参照してください。
+ プライベートウェブサーバーアクセスによる Amazon MWAA デプロイについては、[Apache Airflow ウェブサーバーのカスタムドメインの設定](configuring-custom-domain.md) を参照してください。

### 自分の環境に SSH で接続できますか?
<a name="ssh-dag"></a>

Amazon MWAA 環境ではSSHはサポートされていませんが、`BashOperator` を使用して DAG を作成し、bash コマンドを実行することが可能です。例えば、次のようになります。

```
from airflow import DAG
				from airflow.operators.bash_operator import BashOperator
				from airflow.utils.dates import days_ago
				with DAG(dag_id="any_bash_command_dag", schedule_interval=None, catchup=False, start_date=days_ago(1)) as dag:
				cli_command = BashOperator(
				task_id="bash_command",
				bash_command="{{ dag_run.conf['command'] }}"
				)
```

Apache Airflow UI で DAG をトリガーするには、以下を使用してください。

```
{ "command" : "your bash command"}
```

### VPC セキュリティグループに自己参照ルールが必要なのはなぜですか?
<a name="sg-rule"></a>

自己参照ルールを作成することで、ソースを VPC 内の同じセキュリティグループに制限することができ、ネットワーク全体には公開されません。詳細については、[Amazon MWAA の VPC のセキュリティ](vpc-security.md) を参照してください。

### IAM の異なるグループの環境を非表示にすることはできますか?
<a name="hide-environments"></a>

で環境名を指定することでアクセスを制限できます AWS Identity and Access Managementが、アクセスフィルタリングは AWS コンソールでは使用できません。ユーザーが 1 つの環境にアクセスできる場合は、すべての環境にアクセスできます。

### 一時データを Apache Airflow ワーカーに保存できますか?
<a name="store-data"></a>

Apache Airflow オペレータはワーカーに一時データを保存できます。Apache Airflow ワーカーは、お客様の環境の Fargate コンテナにある `/tmp` の一時ファイルにアクセスできます。

**注記**  
[Amazon ECS Fargate1.4](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/fargate-task-storage.html#fargate-task-storage-linux-pv) によると、タスクストレージの合計は 20 GB に制限されています。後続のタスクが同じ Fargate コンテナインスタンスで実行される保証はありません。この Fargate コンテナインスタンスは別の `/tmp` フォルダを使用する可能性があります。

### 25 個以上の Apache Airflow ワーカーを指定できますか?
<a name="scaling-quota"></a>

はい。Amazon MWAA コンソールでは最大 25 の Apache Airflow ワーカーを指定できますが、クォータの引き上げをリクエストすることで、1 つの環境に最大 50 のワーカーを設定できます。詳細については、[Requesting a quota increase](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html) (クォータ引き上げのリクエスト) を参照してください。

### Amazon MWAA は共有の Amazon VPC をサポートしていますか、それとも共有サブネットをサポートしていますか?
<a name="shared-vpc"></a>

Amazon MWAA は共有の Amazon VPC または共有サブネットをサポートしていません。環境を作成するときに選択する Amazon VPC は、環境を作成しようとしているアカウントが所有している必要があります。ただし、Amazon MWAA アカウント内の Amazon VPC から共有 VPC にトラフィックをルーティングすることはできます。詳細および共有 Amazon VPC へのトラフィックのルーティングの例については、*Amazon VPC トランジットゲートウェイガイド* の [インターネットへの集中型アウトバウンドルーティング](https://docs.aws.amazon.com/vpc/latest/tgw/transit-gateway-nat-igw.html) を参照してください。

### Apache Airflow でタスクの実行とワークフローオーケストレーションを管理するために、カスタム Amazon SQS キューを作成または統合できますか?
<a name="create-sqs"></a>

いいえ、Amazon MWAA 内でカスタム Amazon SQS キューを作成、変更、または使用することはできません。これは、Amazon MWAA が各 Amazon MWAA 環境に対して独自の Amazon SQS キューを自動的にプロビジョニングおよび管理するためです。

## メトリクス
<a name="q-metrics"></a>

### ワーカーをスケールするかどうかの判断にはどのようなメトリクスが使用されますか?
<a name="metrics-workers"></a>

Amazon MWAA は CloudWatch の **QueuedTasks** と **RunningTasks** をモニタリングして、お客様の環境で Apache Airflow ワーカーをスケールするかどうかを決定します。詳細については、[Amazon Managed Workflows for Apache Airflow のモニタリングとメトリクス](cw-metrics.md) を参照してください。

### CloudWatch カスタムメトリクスを作成するには
<a name="metrics-custom"></a>

CloudWatch コンソールにはありません。ただし、CloudWatch にカスタムメトリクスを書き込む DAG を作成することはできます。詳細については、[DAG を使用して CloudWatch にカスタムメトリクスを書き込む](samples-custom-metrics.md) を参照してください。

## DAG、オペレータ、接続、その他の質問
<a name="q-dags"></a>

### `PythonVirtualenvOperator` は使えますか?
<a name="virtual-env-dags"></a>

Amazon MWAA では `PythonVirtualenvOperator` は明示的にサポートされていませんが、`PythonVirtualenvOperator` を使用するカスタムプラグインを作成することができます。サンプルコードについては、[Apache Airflow Python VirtualEnv オペレータ用のカスタムプラグインを作成する](samples-virtualenv.md) を参照してください。

### Amazon MWAA が新しい DAG ファイルを認識するまでどのくらいかかりますか?
<a name="recog-dag"></a>

DAG は、Amazon S3 バケットからお客様の環境に定期的に同期されます。新しい DAG ファイルを追加した場合、Amazon MWAA が新しいファイルの *使用* を開始するまでに約 300 秒かかります。既存の DAG を更新する場合、Amazon MWAA が更新を認識するまでに約 30 秒かかります。

新しい DAG に対しては 300秒、既存の DAG の更新に対しては 30秒、というこれらの値は、それぞれ Apache Airflow の設定オプション [https://airflow.apache.org/docs/apache-airflow/stable/configurations-ref.html#dag-dir-list-interval](https://airflow.apache.org/docs/apache-airflow/stable/configurations-ref.html#dag-dir-list-interval) および [https://airflow.apache.org/docs/apache-airflow/stable/configurations-ref.html#min-file-process-interval](https://airflow.apache.org/docs/apache-airflow/stable/configurations-ref.html#min-file-process-interval) に対応しています。

### DAG ファイルが Apache Airflow に取り込まれないのはなぜですか?
<a name="dag-file-error"></a>

このセクションでは、以下の問題の発生時に考えられる対策について説明します。

1. 実行ロールに Amazon S3 バケットに対する十分なアクセス許可があることを確認します。詳細については、[Amazon MWAA 実行ロール](mwaa-create-role.md) を参照してください。

1. Amazon S3 バケットに *Block Public Access* が設定され、*バージョニング*が有効になっていることを確認します。詳細については、[Amazon MWAA 用の Amazon S3 バケットの作成](mwaa-s3-bucket.md) を参照してください。

1. DAG ファイル自体を確認します。例えば、各 DAG に固有の DAG ID があることを確認してください。

### 環境から `plugins.zip` または `requirements.txt` を削除できますか?
<a name="remove-plugins-reqs"></a>

現在、plugins.zip や requirements.txt を追加したら環境から削除する方法はありませんが、現在対応中です。当面の回避策は、それぞれ空のテキストまたは zip ファイルを指すことです。詳細については、[Amazon S3 でファイルの削除](working-dags-delete.md) を参照してください。

### Apache Airflow v2.0.2 の管理プラグインメニューにプラグインが表示されないのはなぜですか?
<a name="view-plugins-ui"></a>

セキュリティ上の理由から、Amazon MWAA 上の Apache Airflow ウェブサーバーのネットワーク出力は制限されており、バージョン 2.0.2 環境の Apache Airflow ウェブサーバーにはプラグインや Python の依存関係を直接インストールしません。リストされているプラグインにより、Amazon MWAA は AWS Identity and Access Management (IAM) で Apache Airflow ユーザーを認証できます。

プラグインと Python の依存関係をウェブサーバーに直接インストールできるようにするには、Apache Airflow v2.2 以降で新しい環境を作成することをお勧めします。Amazon MWAA は、Apache Airflow v2.2 以降では Python の依存関係とカスタムプラグインをウェブサーバーに直接インストールします。

### AWS Database Migration Service (DMS) 演算子を使用できますか?
<a name="ops-dms"></a>

Amazon MWAA は [DMS オペレータ](https://airflow.apache.org/docs/apache-airflow-providers-amazon/stable/operators/dms.html)をサポートしています。ただし、このオペレータを使用して Amazon MWAA 環境に関連付けられた Amazon Aurora PostgreSQL メタデータデータベースに対してアクションを実行することはできません。

### AWS 認証情報を使用して Airflow REST API にアクセスする場合、スロットリング制限を 10 トランザクション/秒 (TPS) 以上に増やすことはできますか?
<a name="increase-throttling-limit"></a>

はい、可能です。スロットリング制限を増やすには、[AWS カスタマーサポート](https://aws.amazon.com/contact-us/) にお問い合わせください。

### Amazon MWAA では、Airflow タスク実行 API サーバーはどこで実行されますか?
<a name="task-execution-server"></a>

Amazon MWAA は、ウェブサーバーコンポーネントで Airflow タスク実行 API サーバーを実行します。タスク実行 API は、Apache Airflow v3 以降でのみ使用できます。Amazon MWAA アーキテクチャの詳細については、[アーキテクチャ](what-is-mwaa.md#architecture-mwaa) を参照してください。