# カスタムビジュアル変換を開始する
<a name="custom-visual-transform-getting-started"></a>

 カスタムビジュアル変換を作成するには、次の手順を実行します。
+  ステップ 1. JSON 設定ファイルを作成する 
+  ステップ 2. 変換ロジックを実装する 
+  ステップ 3. カスタムビジュアル変換を検証する 
+  ステップ 4. 必要に応じてカスタムビジュアル変換を更新する 
+  ステップ 5. AWS Glue Studio でカスタムビジュアル変換を使用する 

 Amazon S3 バケットをセットアップして開始し、**ステップ 1。JSON 設定ファイルを作成する**に進みます。

## 前提条件
<a name="custom-visual-transform-prerequisites"></a>

 お客様提供の変換はお客様の AWS アカウント内にあります。そのアカウントは変換を所有しているため、変換を表示 (検索、使用)、編集、削除するすべてのアクセス許可を持っています。

 AWS Glue Studio でカスタム変換を使用するには、その AWS アカウントの Amazon S3 アセットバケットに次の 2 つのファイルを作成してアップロードする必要があります。
+  **Python ファイル** – 変換関数が含まれています 
+  **JSON ファイル** – 変換を記述します。これは、設定ファイルとも呼ばれ、変換の定義に必要です。

 ファイルをペアリングするには、両方に同じ名前を使用します。例えば、次のようになります。
+  myTransform.json 
+  myTransform.py 

 必要に応じて、アイコンを含む **SVG ファイル**を指定することで、カスタムビジュアル変換にカスタムアイコンを付加できます。ファイルをペアリングするには、次のように、アイコンに同じ名前を使用します。
+  myTransform.svg 

 AWS Glue Studio では、それぞれのファイル名を使用して自動的に照合されます。ファイル名を既存のモジュールと同じにすることはできません。

## 推奨される変換ファイル名の命名規則
<a name="custom-visual-transform-recommended-transform-file-name"></a>

 AWS Glue Studio では、ファイルはモジュール (例えば、`import myTransform`) としてジョブスクリプトにインポートされます。そのため、ファイル名は Python の変数名 (識別子) に設定されているのと同じ命名規則に従う必要があります。具体的には、文字またはアンダースコアで始まり、文字、数字、および/またはアンダースコアのみで構成されている必要があります。

**注記**  
 予期しない実行時の問題を避けるため、変換ファイル名がロードされている既存の Python モジュール (`sys, array, copy` など) と競合していないことを確認してください。

## Amazon S3 バケットのセットアップ
<a name="custom-visual-transform-setting-up-s3"></a>

 作成した変換は Amazon S3 に保存され、AWS アカウントによって所有されます。すべてのジョブスクリプトが現在保存されている Amazon S3 アセットフォルダ (例えば、`s3://aws-glue-assets-<accountid>-<region>/transforms`) にファイル (json と py) をアップロードするだけで、新しいカスタムビジュアル変換を作成できます。カスタムアイコンを使用している場合は、それもアップロードします。デフォルトでは、AWS Glue Studio は同じ S3 バケット内の /transforms フォルダからすべての .json ファイルを読み取ります。