MacOSXでのOracleSQLDeveloper入門

はじめに

このチュートリアルの目的は、MacOSXオペレーティング・システムにOracleSQLDeveloperをインストールするために必要な手順を提供することです。 WindowsにOracleSQLDeveloperをインストールするための同様の手順は、このリンクにあります。このチュートリアルは、MacOSX Mojave（バージョン10.14）を使用して作成されました。

Oracle SQL Developerは、Oracleデータベースと対話するための多くの機能を備えた強力な開発ツールです。 SQL Worksheetを使用してSQLステートメントを記述および送信することに加えて、SQL Developerには、データベースの管理、データモデルを使用したデータベースの設計とリバースエンジニアリング、およびデータマイニングジョブの実行のための強力なツールがあります。最新バージョン（2019年12月20日現在のバージョン19.4）には、いくつかの基本的なデータベース管理ツール、RESTクエリのサポート、JSONドキュメントの解析も含まれています。

Oracle SQL Developerでは、適切なバージョンのJavaをインストールする必要があります。これは、SQLDeveloperをMacOSXで動作させる上でおそらく最も紛らわしい部分です。適切なJavaDevelopmentKit（JDK）をインストールする手順については、次のページで説明します。

JDKをインストールした後、このチュートリアルの次のセクションでは、SQLDeveloperのダウンロードとインストールについて説明します。 SQL Developerをすでにダウンロードしてインストールしている場合は、このページに進んで、新しいデータベース接続を作成する方法を学ぶことをお勧めします。

このチュートリアルの終わりに向けて、SQLステートメントの記述、実行、保存の方法、SQL Developerを使用したデータのエクスポート方法、SQLDeveloperを使用したOracleへのデータのインポート方法について説明したページがいくつかあります。 SQLDeveloperを使用してOracleスキーマをリバースエンジニアリングすることもできます。そのチュートリアルはここにリンクされています。

MacOSXへのJavaのインストールと構成

Oracle SQL Developerでは、MacOSXオペレーティング・システムにJava Runtime Environment（JRE）またはJava Development Kit（JDK）をインストールする必要があります。残念ながら、実行しているMacOSXのバージョンによっては、Javaのバージョンが新しすぎるか、古すぎるか、まったくインストールされていない可能性があります。私の知る限り、MacOSXバージョンで期待できることを以下に概説します。

Mac OS Xバージョン10.6以前には、AppleのJavaランタイム環境が付属しています。 JRE6やJRE7などの古いJREである可能性があります。これらは現在のバージョンのOracleSQLDeveloper（バージョン18または19）では機能しないため、バージョン8または11などの新しいバージョンのJavaをインストールする必要があります。

Mac OS Xバージョン10.7以降には、JREまたはJDKがまったくインストールされていません。

Javaをインストールするには、OracleJavaダウンロードページにアクセスしてください

https://www.oracle.com/technetwork/java/javase/downloads/index.html

Javaの最新バージョンが上部に表示されることに注意してください。 2019年9月の時点で、Javaバージョン12はOracleSQLDeveloperバージョン19では動作しません。

JavaSE8のセクションまで下にスクロールします。

JDK（Java Development Kit）のダウンロードボタンをクリックします

ラジオボタンをクリックしてライセンス条項に同意し、MacOSXの適切なファイル名を見つけます。ファイル名をクリックして、ダウンロードプロセスを開始します。この例では、JDKバージョン8アップデート221が選択されているため、ファイル名はjdk-8u221-macosx-x64.dmgです。

Oracle Webサイトに初めてアクセスする場合は、ログインするように求められます。OracleWebサイトにログインしていない場合は、アカウントの作成をクリックしてください。ボタンをクリックし、それらの指示に従ってアカウントを作成します。 Oracle Webサイトにすでにログインしている場合は、それらの資格情報を入力して、サインインをクリックします。ボタン。その時点でダウンロードが開始されます。ダウンロードが完了したら、[ダウンロード]アイコンをクリックしてから、JDKファイル名をクリックします：jdk-8u221-macosx-x64.dmg

ダウンロードフォルダの.dmgファイルをクリックすると、ファイルが開きます。

ダウンロードしたファイルを開くと、以下に示すように、.pkgインストールファイルが独自のフォルダーに表示されます。この.pkgインストールファイルをダブルクリックして、JDKインストーラを起動します。

「Appleが悪意のあるソフトウェアをチェックできないため、JDK Update xxxを開くことができません」というエラーが表示された場合は、Appleのこの記事に従って設定を変更する必要があります。

JDKインストーラの最初の画面は情報画面です。 [続行]ボタンをクリックします。

次の画面には、使用されるディスク容量が表示されます。少なくともこれだけの空きディスク容量があることを確認してから、[続行]ボタンをクリックしてください。

次に、ローカルのMacOSXアカウント名とパスワードの入力を求められます。これにより、インストーラーはMacにJDKをインストールし続けることができます。ログイン資格情報を入力し、インストールの開始をクリックしますボタン。

JDKインストーラーは新しいファイルをハードディスクに書き込みます。

完了すると、[概要]画面が表示されます。 閉じるをクリックしますボタン。

JDKのインストールをテストするには、ターミナルウィンドウを開きます。

コマンド/usr/ libexec / java_homeを入力して、JDKがインストールされている場所を確認します。この例では、JDKが1つだけインストールされています。

Javaのバージョンを確認するには、次のコマンドを入力します。java -version

注：現在複数のJavaバージョンがインストールされている場合は、/ usr / libexec / java_homeプログラムを使用してデフォルトを変更し、MacOSXが別のバージョンではなくJavaバージョン1.8を使用するようにする必要があります。

この時点で、優れたJava Development Kit（JDK）がインストールされ、OracleSQLDeveloperのダウンロードと実行に進むことができます。これらの手順は次のページに続きます。

SQLDeveloperのダウンロードとインストール

SQL Developerは、OracleWebサイトから無料でダウンロードできます。

Safari Webブラウザ（または他のWebブラウザ）を開き、https：//www.oracle.com/tools/downloads/sqldev-downloads.html

に移動します。

MacOSXのセクションまで下にスクロールします。 JDKの要件をメモします。適切なJDKがまだインストールされていない場合は、続行する前に、最初に戻ってこれらの手順を完了してください。 ダウンロードをクリックしますリンク。

チェックボックスをオンにしてOracleライセンス契約に同意し、灰色の[ダウンロード]ボタンをクリックします。

この時点で、OracleWebサイトのログイン画面が表示されます。 Oracle Webサイトのアカウントをお持ちでない場合は、アカウントの作成をクリックしてください。ボタンを押して、それらの手順に従います。 Oracle Webサイトのユーザー名とパスワードを取得したら、それらのクレデンシャルを入力して、サインインをクリックします。ボタン。

この時点でダウンロードが開始されます。

ダウンロードが完了したら、[ダウンロード]アイコンをクリックして、ダウンロードしたファイルがポップアップ表示されることを確認します。

SQL Developerファイル名をクリックすると、ファイルが開きます。 SQL Developerを初めて実行すると、次のようなセキュリティ警告が表示される場合があります。開くをクリックしますボタンをクリックして続行します。

SQL Developerを初めて実行すると、プログラムが「システムイベントを制御」できるようにするためのプロンプトが表示される場合があります。 OKをクリックしますボタンをクリックして続行します。

SQLDeveloperのロード画面が次のように表示されます。

SQL Developerのロードが完了すると、アプリケーションは次のように表示されます。

これでSQLDeveloperがダウンロードされて実行され、Oracleデータベースサーバーへの接続の作成に進むことができます。これらの手順については、次のページで説明します。

Oracleデータベースへの接続の作成

SQL Developerには、Oracleリレーショナル・データベース、Oracle NoSQLデータベース、および使用可能なJDBCドライバーがインストールされている他のデータベースやデータ・ソースに接続する機能があります。 Oracleリレーショナルデータベースに接続するには、左上隅の接続の下にある緑色のプラス記号をクリックします。セクション。ポップアップメニューから[新しいデータベース接続...]を選択します。

ターゲットDBMSがOracleCloudのAutonomousDatabaseである場合は、OracleCloudWalletを使用するわずかに異なる手順に従う必要があることに注意してください。自律型データベースへの接続を設定するには、次の手順（6ページ）に従ってください。

新しい接続に名前を付けてから、ユーザー名とパスワード、データベースサーバーのホスト名（またはIPアドレス）、Oracleリスナーが実行されているポート番号、サービス名（またはSID）などの必要な接続設定を入力します。インスタンスの。この情報は、データベース管理者から提供される必要があります。

独自のローカルOracleインスタンスを実行している場合は、 localhostを使用できます。サーバーのホスト名として。追加の接続例は、このチュートリアルの後半に記載されています。

この接続情報を入力したら、テストをクリックします接続をテストするためのボタン。エラーがある場合は、接続設定を編集して、テストをクリックします。左下隅のステータスが成功に変わるまで、もう一度ボタンを押します以下に示すように。

保存をクリックしますボタンをクリックして接続設定を保存し、[接続]をクリックしますデータベースへのライブ接続を確立するためのボタン。

データベース接続が確立されると、接続が左側に表示され、拡張できます（ + をクリックして） sign）データベースのさまざまなテーブル、ビュー、およびその他のコンテンツを表示します。新しいSQLエディタウィンドウが右側に表示され、SQLステートメントを入力してデータベースに送信して実行できます。結果はSQLエディタウィンドウの下のパネルに表示されます。

画面の4つの主要な領域は次のとおりです。

接続ウィンドウ、レポートナビゲータウィンドウ、SQLワークシートおよびスクリプト出力ウィンドウ。 SQLワークシートでSQLステートメントを実行するまで、[スクリプト出力]ウィンドウが表示されない場合があります。何らかの理由でSQLワークシートにアクセスできない場合は、ツールをプルダウンします。メニューからSQLワークシートを選択しますメニュー項目。

SQLステートメントは、SQLワークシートに直接入力するか、別のドキュメント、Webページ、電子メールなどから貼り付けることができます。

SQLワークシートには、orcl_localhost.sql

などのデフォルトのファイル名が付けられています。

このファイルは、PCの任意のローカルフォルダに保存できます。このファイルを保存することは、SQLステートメントを作成および再作成するときにSQLステートメントの履歴を追跡するための優れた方法です。

既存のSQLスクリプトファイルを開くには、[ファイル]メニューをプルダウンして[開く]を選択します。 SQLスクリプトファイルのあるフォルダに移動し、それを強調表示して、[開く]ボタンをクリックします。

SQLDeveloperを使用したOracleデータのエクスポート

SQL Developerには、Oracleの表またはビューからデータを非常に簡単にエクスポートできる機能があります。ターゲットデータベースまたはデータツールの機能に応じて、Oracleからデータをエクスポートする方法は多数あります。データをエクスポートする一般的な例は次のとおりです。

別のデータベースのデータを使用してテーブルを再作成するために使用されるSQLデータ定義言語およびSQLINSERTステートメントファイル。
データを別のOracleデータベースまたはスキーマにインポートするために使用できるOracleSQLLoaderファイルとスクリプト。
さまざまなソフトウェアツールやデータベースなどでインポートできるカンマ区切り値（.csv）ファイル
MicrosoftExcelファイル
さまざまなソフトウェアツールにインポートできるeXtensibleMarkupLanguage（XML）ファイル
Webページに表示できるハイパーテキストマークアップ言語（HTML）ファイル
間隔が固定されているか、さまざまなソフトウェアツールやデータベースからインポートできる他の区切り文字を使用したプレーンテキストファイル。

この例では、エクスポート可能なスキーマ（接続）にデータを含むテーブルまたはビューが少なくとも1つあることを前提としています。スキーマに何も含まれていない場合は、基本テーブルを作成し、以下のSQLステートメントを使用してデータを追加します。

-- Create a simple Employee table
CREATE TABLE employee
(  employee_id  INTEGER NOT NULL, 
   first_name VARCHAR2(35), 
   last_name VARCHAR2(65), 
   salary NUMBER(12,2), 
   department_number INTEGER
);

-- Add three new records to the employee table
INSERT INTO employee VALUES (101, 'Joe', 'Smith', 47000.00, 1);
INSERT INTO employee VALUES (102, 'Alice', 'Jones, 49000.00, 2);
INSERT INTO employee VALUES (103, 'Greg', 'Brown', 42500.00, 1, 2);

開始するには、SQLDeveloper画面の左側にある「接続」領域のナビゲーションツリーを開きます。接続の名前の下に、テーブル、ビュー、編集ビュー、インデックスなどが一覧表示されます。 テーブルを開きますおよびビュー カテゴリも同様です。

この例では、EMPLOYEEテーブルがエクスポートされます。

EMPLOYEEテーブルを右クリックし、以下に示すように[エクスポート...]メニュー項目を選択します。

これにより、短いエクスポートウィザードが表示されます。

Oracleテーブルをエクスポートするためのデフォルト設定

ターゲットデータベースまたはデータツールの機能に応じて、Oracleからデータをエクスポートする方法は多数あります。この例では、EMPLOYEEテーブルがMicrosoftExcelスプレッドシートにエクスポートされます。

CSVファイルまたはスプレッドシートにエクスポートする場合、テーブルまたはビューの構造を指定するデータ定義言語（DDL）を含める必要はありません。したがって、この例では、DDLのエクスポートの横にあるチェックボックスを削除します。

データのエクスポート セクションで、形式を変更します： Excel 2003+（xlsx）

この形式設定では、最大100万行に対応できるExcelの新しいファイル形式が使用されます。古いバージョンのExcelとの下位互換性のために、代わりに Excel ’95 – 2003（xls）を選択できます。フォーマットとして。

データワークシート名：の横のテキストボックスで、新しいワークシートに名前を付けますプロンプト。

Oracleからデータを引き出すために使用されるSQLステートメントのテキストを含める場合は、[ワークシート名のクエリ]の横のチェックボックスをオンにしてから、SQL構文が表示されるExcelワークシートの新しい名前を指定します（この例では、 SQLコードを含めないことを選択しました。

最後のセクションでは、データをファイルまたはファイルのセットに保存する方法を指定します。この例では、データは単一のファイルにエクスポートされます。次に、ファイル名がファイル：の横のテキストボックスに表示されます。促す。 [参照...]ボタンを使用して、十分な空きディスク容量があるフォルダ（ディレクトリ）を見つけます。次に、ファイル名をパスに追加します。

これらすべてを設定したら（以下を参照）、[次へ>]ボタンをクリックします。

次の画面では、エクスポートするデータの列や行をフィルタリングする2つの機会が提供されます。

デフォルトでは、すべての列とすべての行がエクスポートされます。特定の列を選択するには、列の下のテーブルの横にあるスペースをクリックします見出し。次に、鉛筆アイコンをクリックして編集します。データエクスポートに含まれる列の横にチェックマークが付いた新しいウィンドウがポップアップ表示されます。この例では、すべての列がエクスポートされます。

[OK]をクリックして、[データ列]ウィンドウを閉じます。

エクスポートする行をフィルタリングするために、WHERE句を追加できます。 Object Where見出しの下のスペースをクリックし、鉛筆アイコンをクリックしてWhereエディターを表示します。

必要な条件（department_number =1など）を追加します。この例では、すべてのデータをエクスポートするため、Where条件は追加されていません。 [OK]ボタンをクリックして、完了したら[データの場所]ウィンドウを閉じます。

[次へ>]ボタンをクリックして、[概要のエクスポート]画面を表示します。この画面では、すべてのエクスポートオプションの概要が指定されています。

いずれかのオプションが正しく設定されていない場合は、<戻るボタンを使用して前の手順に戻り、必要に応じて調整します。

すべてのエクスポートオプションに問題がない場合は、[完了]ボタンをクリックしてエクスポートジョブを開始します。

エラーが発生した場合は、実際に存在する宛先フォルダーを指定していることを確認してください（このチュートリアルにあるものを盲目的にコピーしないでください）。また、たとえば、宛先ファイルがExcelでまだ開かれていないことを確認してください。

Windowsエクスプローラーを使用してフォルダーに移動し、新しくエクスポートされたファイルを表示します。例：

Excelファイルを開いて内容を表示します：

データを再度エクスポートする前に、必ずExcelファイルを閉じてください。

SQLDeveloperを使用したデータのインポート

SQL Developerには、さまざまなデータソースからOracleにデータを非常に簡単にインポートできる機能があります。データのソースに応じて、Oracleにデータをインポートする方法は多数あります。 SQLDeveloperがインポートできる一般的なデータ形式には次のものがあります。

Oracleでデータを使用してテーブルを再作成するために使用されるSQLデータ定義言語およびSQLINSERTステートメントファイル。
データをOracleにインポートするために使用できるOracleSQLLoaderファイルとスクリプト。
カンマ区切り値（.csv）ファイル
Microsoft Excelファイル（.xlsおよび.xlsx）
eXtensible Markup Language（XML）ファイル
固定間隔または他の区切り文字を使用したプレーンテキストファイル

この例では、SQLDeveloperを介して作成されたOracleデータベースへの接続があることを前提としています。

インポートするファイルは、ここにリンクされているcustomers_export.csvファイルになります。データは次のようになります（21列の319行）：

データインポートの開始

開始するには、SQLDeveloper画面の左側にある「接続」領域のナビゲーションツリーを開きます。 テーブルを右クリックします入力して、ポップアップメニューから[データのインポート...]メニュー項目を選択します。

この時点で、古いバージョンのSQL Developer（4.1.3より前）では、インポートするファイルを選択できるファイル選択ダイアログボックスが表示されます。 SQL Developerの新しいバージョン（4.1.3以降）では、以下に示すように、データインポートウィザードの最初のステップが表示されます。

新しいSQLDeveloperの場合は、「ブラウザ」ボタンをクリックして「ファイル選択」ダイアログボックスを表示し、ファイルを選択します。

ファイルが置かれているフォルダに移動して選択します。ファイルタイプは、Excelファイル、CSVファイル、およびその他のいくつかの種類のテキストファイルをフィルタリングするように設定されていることに注意してください。

[開く]ボタンをクリックして、データインポートウィザードを開始します。

インポートするデータのプレビューと設定の確認

データインポートウィザードの最初のステップは、インポートされるデータのプレビューを提供します。この例では、CSVファイルには、インポートウィザードが変数名を作成するために使用するヘッダーの行があります。ウィザードのこのステップには、開始時にいくつかの行をスキップする（この例では0）、フォーマット（この例ではcsv）、文字エンコード、テキストまたは文字列と行を囲むために使用される引用記号を選択する追加のオプションがありますエンディング/ターミネーター。ほとんどの場合、これらの設定はデフォルトのままにしておくことができます。

特定の状況で役立つ可能性のあるいくつかの変更は次のとおりです。

CSVファイルがLinuxまたはMacオペレーティングシステムで作成された場合にのみ、ラインターミネータをラインフィードに変更します。
エンコーディングを、ワールドリージョン（またはCSVファイルが生成されたワールドリージョン）に一致する特定のコードページに変更します。
プレビュー行の数を変更し、データをスクロールして、すべてが正しく解析されていることを確認します。

すべての設定が適切で、プレビューされたデータが適切である場合は、[次へ>]ボタンをクリックして次のステップに進みます。

インポート方法の選択

ウィザードの次のステップは、インポート方法を指定することです。さまざまなインポート方法が提供されています：

挿入–データを新規または既存のテーブルに直接挿入します。
スクリプトの挿入–データをデータベースにロードするために必要なすべてのDDLおよびINSERTステートメントを含むSQLスクリプトファイルを作成します。このスクリプトはすぐに実行することも、別のデータベース接続に移動してそこで実行することもできます。
外部テーブル– Oracle内に外部テーブル構造を設定します。テーブルはデータディクショナリに表示されますが、データは外部ファイルに保持されます。
SQLローダーユーティリティ–データをOracleにインポートするためのSQLローダースクリプトとコマンドを記述します。

この例では、挿入メソッドが使用されるため、データは新しいテーブルに直接挿入されます。

テーブルの名前を入力します。インポートする行を制限する理由がある場合は、行のインポート制限を確認してください。ボックスに入力し、行数を指定します。たとえば、データファイルに数百万の行があるが、データの一部がどのように見えるかを知りたいだけの場合は、インポートされる行の数を制限できます。この例では、すべての行がインポートされます。

[次へ>]ボタンをクリックして、次のステップに進みます。

インポートする列を選択します

ウィザードのステップ3は、インポートする列を選択することです。 使用可能な列の列を強調表示しますウィンドウをクリックし、右矢印をクリックして、選択した列に移動します。窓。この例では、すべての列がインポートされます。

[次へ>]ボタンをクリックして、次のステップに進みます。

各列へのデータ型の割り当て

ウィザードのステップ4では、新しいデータテーブルに作成される列のデータ型とサイズを定義できます。 これは非常に重要なステップです！ 間違ったデータ型が選択された場合、またはデータ型に受信データを保持するのに十分なスペースがない場合、インポートは失敗します。

SQL Developerの新しいバージョンでは、選択された各列のデータプレビューが表示されます。

発生する一般的な問題は次のとおりです。

最大の文字列/テキスト値を収容するのに十分なスペースをVARACHAR列に提供していません。
データにテキスト文字が含まれている場合に、列でNUMBERデータ型を使用します。
日付と時刻をインポートするときに誤った日付または時刻の形式を使用する。

各ソースデータ列にアクセスしますそれらを一度に1つずつクリックします。作業を進めながら、データ型を調整してください。この例では、次の調整が行われます。

CUSTOMER_IDをINTEGERデータ型に変更し、Nullableのチェックボックスを削除します
CUST_FIRST_NAMEはサイズ30のVARCHAR2を使用します
CUST_LAST_NAMEはサイズ60のVARCHAR2を使用します
STREET_ADDRESSはサイズ65のVARCHAR2を使用します
POST_CODEはサイズ20のVARCHAR2を使用します
CITYはサイズ35のVARCHAR2を使用します
STATE_PROVINCEはサイズ6のVARCHAR2を使用します
COUNTRY_IDはサイズ4のVARCHAR2を使用します
COUNTRY_NAMEはサイズ60のVARCHAR2を使用します
REGION_IDはサイズ2のVARCHAR2を使用します
NLS_LANGUAGEはサイズ6のVARCHAR2を使用します
NLS_TERRITORYはサイズ30のVARCHAR2を使用します
CREDIT_LIMITは、サイズ/精度が10、スケールが0のNUMBERを使用します
CUST_EMAILはサイズ60のVARCHAR2を使用します
PRIMARY_PHONE_NUMBERはサイズ30のVARCHAR2を使用します
PHONE_NUMBER_2はサイズ30のVARCHAR2を使用します
ACCOUNT_MGR_IDはサイズ6のVARCHAR2を使用します
LOCATION_GTYPEはINTEGERを使用します
LOCATION_SRIDはINTEGERを使用します
LOCATION_Xは、サイズ/精度が14、スケールが6のNUMBERを使用します
LOCATION_Yは、サイズ/精度が14、スケールが6のNUMBERを使用します

[次へ>]ボタンをクリックして、次のステップに進みます。

インポートパラメータの確認（旧SQL Developer）

古い（4.1.3より前の）バージョンのSQL Developerの場合、データインポートウィザードの最後のステップで、データパラメータと設定によってデータファイルの解析が可能になることを確認できます。この画面を以下に示します：

[確認]ボタンをクリックして、すべての設定が正しく機能していることを確認します。検証プロセスの結果を以下に示します。

問題がある場合は、<戻るボタンを使用して前の画面に戻り、設定を変更してください。

インポートパラメータを保存する（SQL Developerの新しいバージョン）

SQL Developerの新しいバージョン（4.1.3以降）では、最終画面が少し異なります。この時点で設定はすでにチェックされているため、概要画面が表示されます。右上隅にある[状態の保存]ボタンは、すべてのインポート設定をファイルに保存する方法を提供します。この設定ファイルは、次にデータインポートウィザードを実行するときにロードできます。

この例では、新しいバージョンのSQL Developerを使用している場合は、「状態の保存」ボタンをクリックして、設定をoracle_sqldev_import_customersという名前のファイルに保存します。

インポートの実行

いずれの場合も（古いバージョンまたは新しいバージョンのSQL Developer）、データのインポートを開始するには、「終了」ボタンをクリックします。インポートが完了すると、ダイアログボックスが表示されます。インポート中に発生したエラーが表示されます。

SQL Developerに戻り、インポートされたテーブルの構造を表示します。

次に、データを確認し（[データ]タブをクリック）、データ値が正しくインポートされたことを確認します。

SQL Developerの新しいバージョンの場合、保存されたインポート設定ファイルは、データのインポートウィザードの最初のステップでインポートして、データのインポートを再実行する前に再実行またはインポート設定を変更できます。