> ## 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. > Auth0 Search v2 から v3 への移行方法を学びます。 # Search v2 から v3 への移行 ユーザー検索 v2 は、**2019 年 6 月 30 日**をもって提供終了となりました。できるだけ早く、ユーザー検索機能を [検索エンジン v3](/docs/ja-jp/manage-users/user-search) (`search_engine=v3`) へ移行することを強くお勧めします。
## 移行時の注意事項
移行を開始する前に、いくつか知っておくべき点があります。 * v2 が利用できなくなる前に、クエリで 検索エンジン v3 を使用していることを確実にするには、`GET /api/v2/users` エンドポイントへのすべての呼び出しを更新し、`search_engine=v3` パラメーターを含める必要があります。これにより、更新が必要なクエリがあるかどうかを確認できるため、v2 が利用できなくなってもダウンタイムを回避できます。 * [影響を受ける SDK](#impacted-sdks) のいずれかを使用してユーザー検索を実行している場合も、上記のとおり `search_engine=v3` パラメーターを渡す必要があります。 * 正規化されたユーザーフィールド (`email`、`name`、`given_name`、`family_name`、`nickname`) の検索値では、大文字と小文字は区別されません。それ以外のすべてのフィールド (`app_metadata`/`user_metadata` のすべてのフィールドを含む) では、大文字と小文字が区別されます。 * v3 では、取得できるユーザー数は 1000 人までに制限されます。この上限に達する場合は、より細かい結果を取得できるよう、検索クエリを見直すことをお勧めします。ある時点で 1000 人を超えるユーザー一覧が必要な場合は、代わりに [Export Job](https://auth0.com/docs/api/management/v2#!/Jobs/post_users_exports) API エンドポイントまたは [User Import / Export Extension](/docs/ja-jp/manage-users/user-migration/user-import-export-extension) を使用することをお勧めします。 * `app_metadata`/`user_metadata` フィールドでは、範囲検索およびワイルドカード検索は利用できません。 * ユーザーフィールドは v2 のようにトークン化されないため、`user_id:auth0` は値が `auth0|12345` の `user_id` には一致しません。代わりに `user_id:auth0*` を使用してください。 * ワイルドカードは前方一致に使用できます。たとえば `name:j*` です。それ以外の用途でワイルドカードを使用する場合 (例: 後方一致) 、リテラルは 3 文字以上である必要があります。たとえば、`name:*usa` は使用できますが、`name:*sa` は使用できません。 * `.raw`` フィールド拡張子はサポート対象外となったため、削除する必要があります。v3 では、フィールドは指定した値全体に一致し、`.raw\` 接尾辞のない v2 のようにトークン化はされません。 * v3 では `connection` フィールドはサポートされていません。代わりに、その別名である `identities.connection` を使用してください。
## 移行が必要なクエリ
| ユースケース | v2 | v3 | | ---------------- | --------------------------------- | ----------------------------------------- | | 日付で検索 | `updated_at:>=2018-01-15` | `updated_at:[2018-01-15 TO *]` | | 日付で検索 | `updated_at:>2018-01-15` | `
updated_at:\{2018-01-15 TO *]
` | | 日付で検索 | `updated_at:<=2018-01-15` | `updated_at:[* TO 2018-01-15]` | | 日付で検索 | `updated_at:<2018-01-15` | `updated_at:[* TO 2018-01-15}` | | 日付で検索 | `last_login:<=2017-12` | `last_login:[* TO 2017-12]` | | 文字列の完全一致 | `name.raw:"john richard doe"` | `name:"john richard doe"` | | 語句に単語を含む | `name:"richard"`, `name:richard` | `name:*richard*` | | 語句に単語を含む (3文字未満) | `name:*ri`,`name:*a`, `name:*ab*` | *(サポートされていません)* |
## 影響を受けるSDK
以下のSDKは User Search エンジンを利用しています。これらを使用している場合は、以下に記載されたバージョン (またはそれ以降) を使用し、ユーザー検索を実行する際に `search_engine=v3` パラメータを渡してください。 | SDK | v3 をサポートするバージョン | 影響を受けるメソッド | 注意事項 | | ----------------------------------------------------- | --------------- | ---------------------------------------------- | ------------------------------------------------------------ | | [Auth0 Java](https://github.com/auth0/auth0-java) | 1.8.0 | com.auth0.client.mgmt.UsersEntity.list | `withSearchEngine("v3")` を設定した `UserFilter` を指定します | | [Auth0 Python](https://github.com/auth0/auth0-python) | 3.0.0 | management.Users.list | `search_engine='v3'` パラメータを指定します | | [Auth0 Node](https://github.com/auth0/node-auth0) | 2.0.0 | UsersManager.getAll, ManagementClient.getUsers | `search_engine:'v3'` パラメータを指定します | | [Auth0 .NET](https://github.com/auth0/auth0.net) | 3.0.0 または 4.0.0 | Auth0.ManagementApi.IUsersClient.GetAllAsync | `SearchEngine` = `"v3"` を設定した `GetUsersRequest` オブジェクトを指定します | | [Auth0 PHP](https://github.com/auth0/auth0-php) | 5.2.0 | Auth0.SDK.API.Management.Users.getAll | `'search_engine' => 'v3'` パラメータを指定します | | [Auth0 Ruby](https://github.com/auth0/ruby-auth0) | 4.5.0 | Auth0.Api.V2.Users.users | `search_engine: 'v3'` パラメータを指定します |
## 影響を受けるExtensions
以下の Extensions は User Search エンジンを使用しています。これらをインストールしている場合は、以下に記載したバージョン (またはそれ以降) を使用していることを確認してください。 | 拡張機能 | v3 のサポートバージョン | 注意事項 | | ----------------------------------------------------------------------------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Authorization Extension](/docs/ja-jp/customize/extensions/authorization-extension) | 2.5.0+ | これより前のバージョンを使用している場合は、[Extensions](https://manage.auth0.com/#/extensions) ページから拡張機能を手動で更新する必要があります。 | | [Delegated Administration](/docs/ja-jp/customize/extensions/delegated-administration-extension) | 3.1+ | これより前のバージョンを使用している場合は、[Extensions](https://manage.auth0.com/#/extensions) ページから拡張機能を手動で更新する必要があります。3.1 では User Search v3 のみが利用可能なため、`SEARCH_ENGINE` 設定は廃止されています。 |
## テナントログを活用して User Search v2 の使用箇所を特定する
[Auth0 Dashboard](https://manage.auth0.com/#/logs) の [ログ](/docs/ja-jp/deploy-monitor/logs) を活用すると、SDK による呼び出しも含め、User Search v2 エンジンを使用する `/api/v2/users` エンドポイントへの呼び出しを見つけることができます。これらのログは、アプリケーション内のどこでコードの変更が必要になる可能性があるかを特定するのに役立ちます。 User Search v2 に関連するログをすべて取得するには、次のクエリを使用します: `type:w AND description:*search_engine*`。次のような場合、ログの description フィールドに追加情報が表示されます。 * v3 で異なる結果になる可能性があるクエリ * v3 と互換性のない構文を含むクエリ * v3 のページング要件を満たしていないクエリ ログエントリに追加の詳細が表示されていない場合は、クエリは v3 と互換性がある可能性が高いと考えられます。ただし、変更を本番環境にデプロイする前にクエリをテストすることを引き続き推奨します。 同じ種類のログは、60 分以内に 1 件しか生成されない点にご注意ください。つまり、User Search エンドポイントに対して複数回呼び出しを行っていても、1 時間あたり各種類につき 1 件のログしか表示されません。