製品をチェック

製品をチェック

AWS Marketplace でSybase Glue Connector の利用を開始

AWS Marketplace へ

AWS Glue Studio でSybase データ連携のETL 処理を作成

AWS Glue Studio からSybase データに連携して、リアルタイムSybase データにCData Glue Connector を使ってETL 処理を構築。

加藤龍彦
デジタルマーケティング

最終更新日:2022-11-20

こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

AWS Glue はAmazon が提供するETL サービスで、ビジネスデータをストレージやアナリティクスプラットフォームに簡単にロード・加工ができます。CData Glue Connectors を使うことで、Glue Studio でノーコード・ローコードでETL ジョブを作成することが可能になります。この記事では、CData Glue Connector for Sybase を使って、Sybase データ連携を行うAWS Glue ジョブを作成していきます。

IAM ロールの設定

AWS Glue ジョブを作成するには、AWS のIAM ロールを設定する必要があります。 IAM ロールは、Glue ジョブが関連するすべてのリソース(Amazon S3 のリソース、ターゲット、スクリプト、テンポラリーディレクトリ、AWS Glue Catalog オブジェクトを含む)にアクセス権限を持つ必要があります。また、AWS Glue Marketplace で購入するCData Glue Connector for Sybase へのアクセス権限も必要です。

ミニマムで、以下のポリシーをIAM ロールに追加する必要があります:

  • AWSGlueServiceRole (Glue Studio およびGlue Jobs へのアクセス)
  • AmazonEC2ContainerRegistryReadOnly (CData AWS Glue Connector for Sybase へのアクセス)

Amazon S3 データにアクセスする場合は以下を追加:

  • AmazonS3FullAccess (Amazon S3 への読み書き)

接続プロパティの保存にAWS Secrets Manager を使う場合、インラインでポリシーを追加して、Glue ジョブに必要な特定のsecrets へのアクセスを許容:

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "secretsmanager:GetResourcePolicy", "secretsmanager:GetSecretValue", "secretsmanager:DescribeSecret", "secretsmanager:ListSecretVersionIds" ], "Resource": [ "arn:aws:secretsmanager:us-west-2:111122223333:secret:aes128-1a2b3c", "arn:aws:secretsmanager:us-west-2:111122223333:secret:aes192-4D5e6F", "arn:aws:secretsmanager:us-west-2:111122223333:secret:aes256-7g8H9i" ] } ] }

AWS Glue Studio およびGlue Job でのアクセス権限についての詳細情報は、「Setting up IAM Permissions for AWS Glue in the AWS Glue」ドキュメントを参照してください。

Amazon S3 バケットへのアクセス権限についての詳細情報は、「Amazon Simple Storage Service Developer Guide」を参照してください。

シークレットへのアクセスコントロール設定については、AWS Secrets Manager ドキュメントの「Authentication and Access Control for AWS Secrets Manager」および「Limiting Access to Specific Secrets」を参照してください。AWS Secret Manager から取得されたクレデンシャル(key-value ペアの文字列)は、CData Glue Connector がデータソースに接続する際に使われます。

Sybase 接続プロパティの取得

Sybase は、Basic 認証、Kerberos 認証、LDAP 認証などの認証方法をいくつかサポートしています。

Basic 認証を使用した接続

次を設定してデータを認証し接続します。User およびPassword を設定してSybaseIQ 認証を使用します。

  • User:認証Sybase ユーザーのユーザー名に設定。
  • Password:認証Sybase ユーザーのパスワードに設定。
  • Server:SybaseIQ またはSAP SQL Anywhere データベースインスタンスの名前またはネットワークアドレスに設定。
  • Database:指定されたサーバーで実行されているSybaseIQ またはSAP SQL Anywhere データベースの名前に設定。

オプションで、UseSSL をtrue に設定することにより、TLS/SSL で接続を保護できます。

Note: 上記のCData 製品 設定でSAP SQL Anywhere のインスタンスに接続することもできます。

Kerberos 認証を使用した接続

Kerberos 認証を活用するには、次の接続プロパティを使用してそれを有効にすることから始めます。

  • AuthScheme:Kerberos に設定すると、Sybase への認証に使用されます。

Kerberos 認証用に設定する必要がある接続プロパティに関しては、Kerberos の使用 情報を参照してください。

以下は接続文字列の例です。 Server=MyServer;Port=MyPort;User=SampleUser;Password=SamplePassword;Database=MyDB;Kerberos=true;KerberosKDC=MyKDC;KerberosRealm=MYREALM.COM;KerberosSPN=server-name

LDAP 認証を使用した接続

LDAP 認証で接続するには、LDAP 認証メカニズムを使用するようにSybase サーバーサイドを設定する必要があります。

LDAP 用にSybase を設定したら、Basic 認証と同じクレデンシャルを使用して接続できます。

CData Glue Connector for Sybase で使用するので必要なプロパティの値をメモしておきます。

(Optional)Sybase Connection Properties Credentials をAWS Secrets Manager に保存する

接続プロパティをセキュアに保存して使用するには、AWS Secrets Manager に保存することができます。

Note: AWS Glue ETL ジョブおよびシークレットは、同じリジョンにホストされる必要があります。リジョンをまたぐシークレットの取得はサポートされていません。

  1. AWS Secrets Manager console にサインインします。
  2. service introduction ページもしくはSecrets list ページで、Store a new secret を選択します。
  3. Store a new secret ページで、Other type of secret を選択します。このオプションはシークレットの構造や詳細を自身で提供するものです。
  4. Sybase への接続プロパティについては"Activate" セクションを参照してください。必要なプロパティに対して、key-value ペアを作ります。例:
    • Username: account user (for example, [email protected])
    • Password: account password
    • Add any additional private credential key-value pairs required by the CData Glue Connector for Sybase

    シークレットの作成については、AWS Secrets Manager User Guide のCreating and Managing Secrets with AWS Secrets Manager を参照してください。

  5. AWS Glue Studio で使用するシークレット名を保存します。

CData Glue Connector for Sybase をサブスクライブする

AWS Glue Studio でCData Glue Connector for Sybase を利用するには、AWS Marketplace でコネクタのサブスクリプションを行う必要があります。すでにCData Glue Connector for Sybase のサブスクリプション契約をしている場合には、この部分はスキップしてください。

  1. AWS Glue Studio でConnectors をクリック
  2. AWS Marketplace にアクセス
  3. "CData Sybase" のコネクタを検索 Selecting a CData AWS Glue Connector
  4. "Continue to Subscribe" をクリック
  5. Connector の使用条件に同意して、リクエストが処理完了を待ちます
  6. "Continue to Configuration" をクリック Accepted Terms and continuing Configuration

Glue Studio でCData Glue Connector for Sybase をアクティベートする

AWS Glue でCData Glue Connector for Sybaseを使うためには、AWS Glue Studio でサブスクライブしたコネクタをアクティベートする必要があります。アクティベートすることで、AWS アカウントにコネクタオブジェクトが作成されます。

  1. コネクタのサブスクリプションが完了したら、AWS Marketplace Connector ページにnew Config タブが表示されます。
  2. デリバリーオプションを選択して、"Continue to Launch" ボタンをクリックします。 Launching the Connector
  3. ローンチタブで、"Usage Instructions" をクリックして、表示されるリンクに従い、接続設定を行います。 Activate the Connector
  4. Connection アクセスで、JDBC URL 形式を選択し、接続設定を行います。以下が一般的なSybase への接続のJDBC URL 接続文字列フォーマットです。Sybase への接続の詳細については、Connector のヘルプドキュメントを参照してください。

    AWS Secrets Manager でのシークレットの保管をしている場合には、プレースホルダーの値 (e.g. ${Property1}) は空白になります。そうでない場合には、入力した値はAWS Glue Connection インターフェースはRead-only のJDBCURL として表示されます。

    Username & Password

    jdbc:cdata:Sybase:User=${Username};Password=${Password};Server=${Server};Port=${Port};Database=${Database} Configure the Connection (Salesforce is shown)
  5. (Optional): コネクタのログ取得を設定。

    CData Glue Connector for Sybase のログ機能を利用する場合、JDBC URL に以下の2つのプロパティを追加しま:

    • Logfile: Set this to "STDOUT://"
    • Verbosity: Set this to an integer (1-5) for varying depths of logging. 1 is the default, 3 is recommended for most debugging scenarios.
  6. Network オプションを設定して"Create Connection" をクリックします。

Amazon Glue ジョブの作成

接続設定の完了後、Glue ジョブを作成することができます。

コネクションを使うジョブを作成

  1. Glue Studio で"Your connections" から作成したConnection を選択します。
  2. Creating a job from the new Connection.
  3. "Create job" をクリックします。

    ジョブエディタが開くので、新しいNode を追加します。Node 詳細パネルの右にSource Properties タブがあります。

Source Node Properties を設定:

Source properties タブでデータソースへの接続オプションを選択できます。AWS Glue Studio ヘルプで詳細を確認してください。ここではシンプルな例を示します。

  1. ジョブエディタで、コネクタのSource Node が選択されていることを確認します。右側のNode 詳細パネルSource Properties タブを選択します。
  2. コネクタ名のConnection フィールドが出てきます。
  3. データソースのデータロケーションを入力します。使用するデータのテーブル名もしくはSQL クエリを直接入力することができます。SQL クエリの例は SELECT Id, ProductName FROM Products WHERE ProductName = Konbu です。 Configuring the Source node.
  4. データソースからTransformation Node にデータを渡すために、AWS Glue Studio ではデータのスキーマを定義する必要があります。"Use Schema Builder" を選択して、スキーマを設定します。
  5. 必要に応じて他のオプションフィールドを設定します:
    • Partitioning information - for parallelizing the read operations from the data source
    • Data type mappings - to convert data types used in the source data to the data types supported by AWS Glue
    • Filter predicate - to select a subset of the data from the data source

    これらのオプションの詳細については"Use the Connection in a Glue job using Glue Studio" を参照してください。

  6. Node properties パネルのOutput スキーマタブで、これらの作成されたスキーマを確認できます。

Glue ジョブの編集、保存、実行

ジョブグラフでNode を追加・編集することでジョブを変更することができます。詳細は、Editing ETL jobs in AWS Glue Studio を参照してください。

ジョブの編集が終わったら、Job Properties を入力します。

  1. グラフエディタでJob Properties タブを選択します。
  2. カスタムコネクタの使用には、以下のJob Properties を設定します:
    • Name: Provide a job name.
    • IAM Role: Choose (or create) an IAM role with the necessary permissions, as described previously.
    • Type: Choose "Spark."
    • Glue version: Choose "Glue 2.0 - Supports spark 2.4, Scala 2, Python 3."
    • Language: Choose "Python 3."
    • 他のパラメータにはデフォルト値を使います。詳細はAWS Glue Developer Guide の"Defining Job Properties" を参照してください。
    Configuring the job properties.
  3. "Save" を押して保存します。
  4. "Successfully created Job" の表示が緑のバナーに出ます。
  5. ジョブの保存後、"Run" をクリックしてジョブを実行します。
  6. "Script" tab を選択すると、ジョブで生成されたスクリプトを見ることができます。"Job runs" タブには、ジョブの実行履歴が出ます。詳細は"View information for recent job runs" を参照してください。 Completed job run details.

Generate Script のレビュー

ジョブ作成において、Script タブをクリックし、Glue Studio が作成するスクリプトを確認することができます。シンプルなSybase データのS3 バケットへの書き込みの場合、スクリプトは以下のようになります:

スクリプトサンプル

import sys from awsglue.transforms import * from awsglue.utils import getResolvedOptions from pyspark.context import SparkContext from awsglue.context import GlueContext from awsglue.job import Job ## @params: [JOB_NAME] args = getResolvedOptions(sys.argv, ['JOB_NAME']) sc = SparkContext() glueContext = GlueContext(sc) spark = glueContext.spark_session job = Job(glueContext) job.init(args['JOB_NAME'], args) ## @type: DataSource ## @args: [connection_type = "marketplace.jdbc", connection_options = {"dbTable":"Products","connectionName":"cdata-sybase"}, transformation_ctx = "DataSource0"] ## @return: DataSource0 ## @inputs: [] DataSource0 = glueContext.create_dynamic_frame.from_options(connection_type = "marketplace.jdbc", connection_options = {"dbTable":"Products","connectionName":"cdata-sybase"}, transformation_ctx = "DataSource0") ## @type: DataSink ## @args: [connection_type = "s3", format = "json", connection_options = {"path": "s3://PATH/TO/BUCKET/", "partitionKeys": []}, transformation_ctx = "DataSink0"] ## @return: DataSink0 ## @inputs: [frame = DataSource0] DataSink0 = glueContext.write_dynamic_frame.from_options(frame = DataSource0, connection_type = "s3", format = "json", connection_options = {"path": "s3://PATH/TO/BUCKET/", "partitionKeys": []}, transformation_ctx = "DataSink0") job.commit()

CData Glue Connector for Sybase をAWS Glue Studio で使って、簡単にSybase データをS3 バケットや他の同期先にETL するジョブを作成することができます。 また、Glue Connector を使って、Sybase にデータを挿入、更新、削除を行うGlue ジョブを作ることもできます。.

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。