> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 外部データベースからユーザーを削除するためのカスタムデータベースのアクション スクリプト テンプレートについて説明します。

# 削除スクリプトテンプレート

Delete スクリプトは、定義された関数を実装し、指定したユーザーを外部データベースから削除します。この関数には `deleteUser` という名前を付けることを推奨します。

このスクリプトは、[レガシー認証シナリオ](/ja/docs/authenticate/database-connections/custom-db/overview-custom-db-connections)でのみ使用されます。Auth0 と外部データベースの両方から同じ操作でユーザーを削除する場合に必要です。

<div id="deleteuser-function">
  ## DeleteUser 関数
</div>

`deleteUser` 関数では、次の処理を行う必要があります。

* 指定したユーザーを外部データベースから削除する。
* 削除に成功した場合は `null` を返す。
* 削除に失敗した場合はエラーを返す。

<div id="definition">
  ### 定義
</div>

`deleteUser` 関数は 2 つのパラメーターを受け取り、`callback` 関数を返します。

```js lines theme={null}
deleteUser(id, callback): function
```

| Parameter  | Type     | Description                          |
| ---------- | -------- | ------------------------------------ |
| `id`       | String   | ユーザーの識別子 `user_id`。`auth0` では始まりません。 |
| `callback` | Function | エラーまたはプロファイルデータをパイプラインに渡すために使用します。   |

### 例

これは、`deleteUser` 関数の実装方法を示す擬似 JavaScript の例です。言語固有の例については、[言語別のスクリプト例](/ja/docs/authenticate/database-connections/custom-db/templates/delete#language-specific-script-examples) を参照してください。

```javascript lines theme={null}
function deleteUser(id, callback) {
  // 外部データベースAPIにユーザー識別子を送信する
  let options = {
    url: "https://example.com/api/deleteUser",
    body: {
      id: id
    }
  };

  send(options, (err, profileData) => {
    // 削除に失敗した場合はコールバックでエラーを返す
    if (err) {
      return callback(new Error("My custom error message."));
    }

    // 削除に成功した場合はコールバックでnull値を返す
    return callback(null);
  });
}
```

<div id="callback-function">
  ## `callback` 関数
</div>

`callback` 関数は 1 つのパラメーターを受け取り、別の関数を返します。

<div id="definition">
  ### 定義
</div>

```js lines theme={null}
callback(error): function
```

| パラメーター  | 型      | 必須 | 説明            |
| ------- | ------ | -- | ------------- |
| `error` | Object | 必須 | エラーデータが含まれます。 |

<div id="return-a-success">
  ### 成功を返す
</div>

外部データベースでユーザーを正常に削除できた場合は、`callback` 関数を返し、`error` パラメーターには `null` を渡します。

<div id="example">
  #### 例
</div>

```js lines theme={null}
return callback(null);
```

<div id="return-an-error">
  ### エラーを返す
</div>

エラーが発生した場合は、`callback` 関数を呼び出し、関連するエラー情報を `error` パラメーターに渡します。

<div id="example">
  #### 例
</div>

```js lines theme={null}
return callback(new Error("My custom error message."));
```

<div id="language-specific-script-examples">
  ## 言語別のスクリプト例
</div>

Auth0 では、次の言語/テクノロジー向けのサンプルスクリプトを提供しています。

* [JavaScript](#javascript)
* [ASP.NET Membership Provider (MVC3 - Universal Providers)](#asp-net-membership-provider-mvc3-universal-providers-)
* [ASP.NET Membership Provider (MVC4 - Simple Membership)](#asp-net-membership-provider-mvc4-simple-membership-)
* [MongoDB](#mongodb)
* [MySQL](#mysql)
* [PostgreSQL](#postgresql)
* [SQL Server](#sql-server)
* [Windows Azure SQL Database](#windows-azure-sql-database)

<div id="javascript">
  ### JavaScript
</div>

```javascript lines theme={null}
function remove (id, callback) {
  // このスクリプトは既存のデータベースからユーザーを削除します。
  // Management API または Auth0 Dashboard からユーザーが削除されるたびに実行されます。
  //
  // このスクリプトの終了方法は2通りあります:
  // 1. ユーザーが正常に削除された場合:
  //     callback(null);
  // 2. データベースへの接続中にエラーが発生した場合:
  //     callback(new Error("my error message"));
  var msg = "Please implement the Delete script for this database " +
       "connection at https://manage.auth0.com/#/connections/database";
  return callback(new Error(msg));
}
```

<div id="aspnet-membership-provider-mvc3-universal-providers">
  ### ASP.NET メンバーシップ プロバイダー (MVC3 - Universal Providers)
</div>

```javascript lines expandable theme={null}
function remove(id, callback) {
  const sqlserver = require('tedious@1.11.0');
  const Connection = sqlserver.Connection;
  const Request = sqlserver.Request;
  const TYPES = sqlserver.TYPES;
  const connection = new Connection({
    userName: 'the username',
    password: 'the password',
    server: 'the server',
    options: {
      database: 'the db name',
      encrypt: true,
      // Membershipエンティティの作成に必要なuserIdを取得するために必要
      rowCollectionOnRequestCompletion: true
    }
  });
  connection.on('debug', function(text) {
    // 接続に問題がある場合は、より詳細な情報を得るためにコメントを解除してください
    // console.log(text);
  }).on('errorMessage', function(text) {
    // SQLデータベースへの接続時またはSQL文の実行時のエラーが表示されます
    console.log(JSON.stringify(text));
  });
  connection.on('connect', function(err) {
    if (err) return callback(err);
    executeDelete(['Memberships', 'Users'], function(err) {
      if (err) return callback(err);
      callback(null);
    });
  });
  function executeDelete(tables, callback) {
    const query = tables.map(function(table) {
      return 'DELETE FROM ' + table + ' WHERE UserId = @UserId';
    }).join(';');
    const request = new Request(query, function(err) {
      if (err) return callback(err);
      callback(null);
    });
    request.addParameter('UserId', TYPES.VarChar, id);
    connection.execSql(request);
  }
}
```

<div id="aspnet-membership-provider-mvc4-simple-membership">
  ### ASP.NET メンバーシップ プロバイダー (MVC4 - Simple Membership)
</div>

```javascript lines expandable theme={null}
function remove(id, callback) {
  const sqlserver = require('tedious@1.11.0');
  const Connection = sqlserver.Connection;
  const Request = sqlserver.Request;
  const TYPES = sqlserver.TYPES;
  const connection = new Connection({
    userName: 'the username',
    password: 'the password',
    server: 'the server',
    options: {
      database: 'the db name',
      encrypt: true,
      // Membershipエンティティの作成に必要なuserIdを取得するために必要
      rowCollectionOnRequestCompletion: true
    }
  });
  connection.on('debug', function (text) {
    // 接続に問題がある場合は、より詳細な情報を得るためにコメントを解除してください
    // console.log(text);
  }).on('errorMessage', function (text) {
    // SQLデータベースへの接続時またはSQL文の実行時のエラーが表示されます
    console.log(JSON.stringify(text));
  });
  connection.on('connect', function (err) {
    if (err) return callback(err);
    executeDelete(['webpages_Membership', 'UserProfile'], function (err) {
      if (err) return callback(err);
      callback(null);
    });
  });
  function executeDelete(tables, callback) {
    const query = tables.map(function (table) {
      return 'DELETE FROM ' + table + ' WHERE UserId = @UserId';
    }).join(';');
    const request = new Request(query, function (err) {
      if (err) return callback(err);
      callback(null);
    });
    request.addParameter('UserId', TYPES.VarChar, id);
    connection.execSql(request);
  }
}
```

<div id="mongodb">
  ### MongoDB
</div>

```javascript lines theme={null}
function remove(id, callback) {
  const MongoClient = require('mongodb@3.1.4').MongoClient;
  const client = new MongoClient('mongodb://user:pass@mymongoserver.com');
  client.connect(function (err) {
    if (err) return callback(err);
    const db = client.db('db-name');
    const users = db.collection('users');
    users.remove({ _id: id }, function (err) {
      client.close();
      if (err) return callback(err);
      callback(null);
    });
  });
}
```

<div id="mysql">
  ### MySQL
</div>

```javascript lines theme={null}
function remove(id, callback) {
  const mysql = require('mysql');
  const connection = mysql({
    host: 'localhost',
    user: 'me',
    password: 'secret',
    database: 'mydb'
  });
  connection.connect();
  const query = 'DELETE FROM users WHERE id = ?';
  connection.query(query, [ id ], function(err) {
    if (err) return callback(err);
    callback(null);
  });
}
```

<div id="postgresql">
  ### PostgreSQL
</div>

```javascript lines theme={null}
function remove(id, callback) {
  //この例では "pg" ライブラリを使用しています
  //詳細はこちら: https://github.com/brianc/node-postgres
  const postgres = require('pg');
  const conString = 'postgres://user:pass@localhost/mydb';
  postgres.connect(conString, function (err, client, done) {
    if (err) return callback(err);
    const query = 'DELETE FROM users WHERE id = $1';
    client.query(query, [id], function (err) {
      // 注意: データベースへの接続を閉じるために
      // 必ずここで `done()` を呼び出してください
      done();
      return callback(err);
    });
  });
}
```

<div id="sql-server">
  ### SQL Server
</div>

```javascript lines expandable theme={null}
function remove(id, callback) {
  // この例では "tedious" ライブラリを使用しています
  // 詳細はこちら: http://pekim.github.io/tedious/index.html
  const sqlserver = require('tedious@1.11.0');
  const Connection = sqlserver.Connection;
  const Request = sqlserver.Request;
  const TYPES = sqlserver.TYPES;
  const connection = new Connection({
    userName:  'test',
    password:  'test',
    server:    'localhost',
    options:  {
      database: 'mydb'
    }
  });
  const query = 'DELETE FROM dbo.Users WHERE id = @UserId';
  connection.on('debug', function (text) {
    console.log(text);
  }).on('errorMessage', function (text) {
    console.log(JSON.stringify(text, null, 2));
  }).on('infoMessage', function (text) {
    console.log(JSON.stringify(text, null, 2));
  });
  connection.on('connect', function (err) {
    if (err) return callback(err);
    const request = new Request(query, function (err) {
      if (err) return callback(err);
      callback(null);
    });
    request.addParameter('UserId', TYPES.VarChar, id);
    connection.execSql(request);
  });
}
```

<div id="windows-azure-sql-database">
  ### Windows Azure SQL Database
</div>

```javascript lines expandable theme={null}
function remove (id, callback) {
  // この例では "tedious" ライブラリを使用しています
  // 詳細はこちら: http://pekim.github.io/tedious/index.html
  var Connection = require('tedious@1.11.0').Connection;
  var Request = require('tedious@1.11.0').Request;
  var TYPES = require('tedious@1.11.0').TYPES;
  var connection = new Connection({
    userName: 'your-user@your-server-id.database.windows.net',
    password: 'the-password',
    server: 'your-server-id.database.windows.net',
    options: {
      database: 'mydb',
      encrypt: true
    }
  });
  connection.on('debug', function (text) {
    console.log(text);
  }).on('errorMessage', function (text) {
    console.log(JSON.stringify(text, null, 2));
  }).on('infoMessage', function (text) {
    console.log(JSON.stringify(text, null, 2));
  });
  connection.on('connect', function (err) {
    if (err) { return callback(err); }
    var query = 'DELETE FROM users WHERE id = @UserId';
    var request = new Request(query, function (err) {
      if (err) { return callback(err); }
      callback(null);
    });
    request.addParameter('UserId', TYPES.VarChar, id);
    connection.execSql(request);
  });
}
```

<div id="learn-more">
  ## 詳細情報
</div>

* [Change Password スクリプトテンプレート](/ja/docs/authenticate/database-connections/custom-db/templates/change-password)
* [Create スクリプトテンプレート](/ja/docs/authenticate/database-connections/custom-db/templates/create)
* [Get User スクリプトテンプレート](/ja/docs/authenticate/database-connections/custom-db/templates/get-user)
* [Login スクリプトテンプレート](/ja/docs/authenticate/database-connections/custom-db/templates/login)
* [Verify スクリプトテンプレート](/ja/docs/authenticate/database-connections/custom-db/templates/verify)
* [Change Email スクリプトテンプレート](/ja/docs/authenticate/database-connections/custom-db/templates/change-email)
